リファレンスマニュアル

This document is Copyright © 2024 by its contributors as listed below. You may distribute it and/or modify it under the terms of either the GNU General Public License (http://www.gnu.org/licenses/gpl.html), version 3 or later, or the Creative Commons Attribution License (http://creativecommons.org/licenses/by/3.0/), version 3.0 or later.

貢献者

Jean-Pierre Charras, Graham Keeth

翻訳

starfort <starfort AT nifty.com>, 2015-2017. kinichiro <kinichiro.inoguchi AT gmail.com>, 2015. yoneken <yoneken AT kicad.jp>, 2011-2015.

フィードバック

The KiCad project welcomes feedback, bug reports, and suggestions related to the software or its documentation. For more information on how to submit feedback or report an issue, please see the instructions at https://www.kicad.org/help/report-an-issue/

Introduction to the KiCad Drawing Sheet Editor

The Drawing Sheet Editor is a tool to create custom drawing sheets for use in the KiCad Schematic and Board Editors. Drawing sheets can include custom title blocks, frames, logos, as well as other text and graphics.

The frame, title block, and other graphic items (logos) are collectively called a drawing sheet.

Basic drawing sheet items are:

  • 線(Line)

  • 矩形(Rect)

  • Text (with keywords that will be replaced by the actual text, like the date, page number…​) in the Schematic or Board Editors.

  • 重畳された多角形(Poly) (主にロゴや特別な図形を配置するためのもの)

  • ビットマップ(Bitmap)

注意:ビットマップ(Bitmap)は一部の出力形式(PDFとPS)でのみプロットできます。それ以外の出力形式では、ただの四角形として出力されます。
  • Items can be repeated, and text and poly_polygons can be rotated.

Drawing Sheet Editor files

The Drawing Sheet Editor reads and writes KiCad drawing sheet files (.kicad_wks). These files can be used as custom drawing sheets for schematic and PCB designs by selecting a custom drawing sheet in the Page Setup dialog in each editor.

When the Drawing Sheet Editor is first opened, it displays the default KiCad drawing sheet is used until a different drawing sheet file is opened.

動作の詳細

Basic drawing sheet item properties

Basic drawing sheet items are:

  • 線(Line)

  • 矩形(Rect)

  • Text (with keywords, with will be replaced by the actual text, like the date, page number…​) in the Schematic or PCB Editors.

  • Poly-polygons (mainly to place logos and special graphic shapes). These poly polygons are created by the Image Converter tool, and cannot be built inside the Drawing Sheet Editor, because it is not possible to create such shapes by hand.

  • ビットマップ(Bitmap) (ロゴを配置するための)

ビットマップ(Bitmap)は一部の出力形式(PDFとPS)でのみプロットできます。

また:

  • Text, poly-polygons and bitmaps are defined by a position, and can be rotated.

  • 線(Line) (多数のセグメントから成る)と 矩形(Rect) は始点/終点の2点の指定となります。 これらは回転できません。(セグメントに対して無効です)

基本的な要素は、繰り返し配置が可能です。

Repeated text also accepts an increment value for labels (has meaning only if the text is one letter or one digit).

座標系の設定

Each position, start point and end point of items is always relative to a page corner. This feature allows you to define a drawing sheet which is not dependent on the paper size.

ページの角(カド)と座標系

page property 1

  • 用紙サイズが変更された場合も、それぞれの要素は基準となるページの角との関係を保ちます。

  • 通常、タイトルブロックは用紙サイズに依らずにページの右下へ表示されます。これは要素を作成した際に右下の角を原点として設定している為です。

矩形(Rect)や線(Line)は、それぞれ原点となる角を指定した2点の座標指定で指定されます。

回転

Items which have a position defined by just one point (text and poly-polygons) can be rotated:

通常時 : 回転 = 0°

text noriented

回転指定: 回転 = 20°/ 10°

text rotated

繰り返し設定

要素は繰り返して配置を行うことが出来ます。

これはグリッド線やグリッドのラベルを作成する際に便利な機能です。

page property 2

Text and keywords

Keywords

Text can be simple strings or can include keywords.

Keywords are replaced by actual values when the drawing sheet is used in a schematic or PCB design. They behave like text variables in the Schematic and Board Editors, except the values are either automatically set by the editor or set by the user in the Page Setup dialog of the respective editor.

The keyword syntax is ${KEYWORD}. The keyword, including the surrounding ${}, will be replaced by the keyword’s value.

Keyword name Description

KICAD_VERSION

Version number of KiCad.

#

Sheet number.

##

Total number of sheets.

COMMENT1 - COMMENT9

Contents of the Comment<n> field in Page Setup.

COMPANY

Contents of the Company field in Page Setup.

FILENAME

Filename of the schematic or PCB design file, with a file extension.

ISSUE_DATE

Contents of the Issue Date field in Page Setup.

LAYER

Name of the current PCB layer. This is blank in the Schematic and Board Editors. It is only shown in plots of PCB designs.

PAPER

Current sheet’s paper size, which is set in Page Setup.

REVISION

Contents of the Revision field in Page Setup.

SHEETNAME

Sheet name of the current sheet. This is blank in the Board Editor.

SHEETPATH

Sheet path of the current sheet. This is blank in the Board Editor.

TITLE

Contents of the Title field in Page Setup.

For example, Size: ${PAPER} displays "Size: A4" when the paper size is set to A4.

When the Preview display mode is active (pagelayout normal view mode 24), the title block is displayed like in the Schematic and PCB Editors, with keywords replaced with the corresponding values. You can configure the displayed values in the Page Preview Settings dialog (sheetset 24).

show fields edit

When the Edit mode is active (pagelayout special view mode 24), the title block is displayed without replacing keywords.

show fields preview

Multi-line text

Text can be multi-line.

There are 2 ways to insert a new line in text:

  1. Insert the \n 2 chars sequence (mainly in Page setup dialog in KiCad).

  2. Insert a new line in the Drawing Sheet Editor Design window.

下記に例を示します:

セットアップ

options multi line

出力

multi line

Multi-line text in Page Setup dialog

In the Page Setup dialog, text controls do not accept multi-line text.

The \n 2 character sequence should be inserted to force a new line inside a text object.

Here is a two line text object, in the Comment2 field:

insert newline code

実際の図面上では、下記のように表示されます:

multi line 2

However, if you really want the \n inside the text, enter \\n.

insert slashnewline code

この場合、実際の図面上では、下記のように表示されます:

multi line 3

制限の設定

1ページ目の設定

When using the Schematic Editor, the full schematic often uses more than one page.

Usually drawing sheet items are shown on all pages, but you can also set each item to be shown only on the first page or on all pages except the first page. To change which pages an item is shown on, use the dropdown in the the item’s Item Properties panel. Options are show on all pages, first page only, and subsequent pages only.

page options

Text maximum size constraint

Text items have a maximum size constraint. You can set a maximum height and maximum width, which together form a bounding box defining the maximum size of the text object.

text max size options

If the text object is bigger than the maximum size in a given dimension, the text object will be dynamically compressed in that dimension in order to fit within the bounding box. This will result in the text being visually distorted. If the text fits within the bounding box, the text will not be compressed.

When either parameter is set to 0, KiCad will not enforce a maximum size in that dimension.

Some text with the maximum height and width set to 0:

text no max width

The same text compressed because the maximum width is set smaller than the width of the text:

text max width

Invoking the Drawing Sheet Editor

The Drawing Sheet Editor is typically invoked from a command line, or from the KiCad Project Manager.

コマンドラインから起動する場合、 pl_editor <*.kicad_wksファイルパス> として呼び出してください。

Drawing Sheet Editor Commands

メイン画面

The image below shows the main window of the Drawing Sheet Editor.

main window

The main part of the screen is the editing canvas for the open drawing sheet.

The right pane is a properties editor for editing the selected item. It only appears when an item is selected in the canvas.

メインウィンドウのツールバー

画面上部に表示されているツールバーから、下記のコマンドを呼び出すことが出来ます:

new generic 24

Create a new drawing sheet.

directory open 24

Load a drawing sheet file.

save 24

Save the current drawing sheet in a .kicad_wks file.

sheetset 24

Display the page size selector and the title block user data editor.

print button 24

Prints the current page.

undo 24 redo 24

Undo/redo tools.

zoom in 24 zoom out 24 refresh 24 zoom fit in page 24

Zoom in, out, redraw and auto, respectively.

pagelayout normal view mode 24

Show the drawing sheet in Preview mode: text is shown like in the Schematic or PCB Editors, with text keywords replaced by user text.

pagelayout special view mode 24

Show the drawing sheet in Edit mode: text is displayed "as is", without any keyword replacement.

set base corner

Reference corner selection, for coordinates displayed to the status bar.

set current page

Selection of the page number (page & or other pages).

This selection has meaning only if some items than have a page option, are not shown on all pages (in a schematic for instance, which contains more than one page).

描画エリア(描画パネル)でのコマンド

キーボードショートカット

F1

拡大

F2

縮小

F3

画面の再描画

F4

現在のカーソル位置の描画を画面中央へ移動させます

Home

画面全体を表示

スペースキー

dx/dy 表示座標をカーソル位置でゼロリセットします。 (dx/dy座標は画面下部ステータスバーに表示されます)

→(右矢印)

カーソルを1グリッド分右へ移動します。

←(左矢印)

カーソルを1グリッド分左へ移動します。

↑(上矢印)

カーソルを1グリッド分上へ移動します。

↓(下矢印)

カーソルを1グリッド分下へ移動します。

マウス操作

ホイール

現在のカーソル位置を中心に拡大/縮小

Ctrl + ホイール

左右方向へスクロール

Shift + ホイール

上下方向へスクロール

右クリック

コンテキストメニューの表示

コンテキストメニュー

(右クリックメニュー)

  • 線の追加

  • 矩形を追加

  • テキスト入力

  • Add Bitmap

  • 中央/ズームイン/ズームアウト/ビューの再描画/自動ズーム/ズームの選択

  • グリッドの選択

ステータスバー

The status bar is located at the bottom of the Drawing Sheet Editor and provides useful information to the user.

pl status bar

Coordinates are always relative to the corner selected as the reference corner in the reference corner dropdown in the menubar.

Properties editor

The right pane is a properties editor. It only appears when an item is selected in the canvas. The Item Properties tab contains properties for the selected item. These properties depend on what type of item is selected. The General Options tab lets you edit default properties and margins for the *sheet.

Changes made in the properties editor are not applied until you click the Apply button.

item properties

general options

Design Inspector window

The Design Inspector shows a table of every item in the drawing sheet and their properties. Selecting an item in the Design Inspector also selects the item on the canvas and leaves it selected when you close the Design Inspector.

To open the Design Inspector, use InspectShow Design Inspector.

design inspector

Interactive editing

要素の選択

要素を選択するには、下記の3通りの方法があります:

  • From the Design Inspector

  • 対象の要素の上で左クリックする

  • 対象の要素の上で右クリックする(要素が選択されると同時に、メニューが表示されます)

When selected, this item is drawn in a lighter shade of color and the properties editor will be displayed for the selected item.

When right clicking on the item, a pop-up menu is displayed. The pop menu contents depend on the type of object selected.

要素の作成

To add a new item, use the appropriate button in the right toolbar and then click on the canvas. The item will be added to the canvas and selected, and the properties editor for the new item will open. You can edit the item’s properties in the properties editor, then click Apply to modify the new item.

The available items are lines (add graphical segments 24), rectangles (add rectangle 24), text (text 24), and bitmaps (image 24).

You can also add new items from the right-click context menu.

Logos must first be created by the Image Converter tool, which creates a page layout description file. You can use the Append Existing Drawing Sheet command to insert the logo (a poly polygon) contained in the new drawing sheet.

Adding lines, rectangles and text

When you add lines, rectangles, or text, the item will be added to the canvas, selected, and shown in the properties editor. You can edit the item’s properties in the properties editor, then click Apply to apply the changes.

You can also move the item in the canvas after it has been placed by dragging it or using the Move command (kbd:[M]). Lines and rectangles can be moved as a shape, but you can also move their points individually.

Lines and rectangles typically use the same corner reference for both the start and end points. If this is not the case, the item’s geometry will change when the sheet size or margins are changed.

ロゴの追加

To add a logo, a poly polygon (the vectored image of the logo) must be first created using the Image Converter tool, which is available in the main KiCad Project Manager window. Polygons cannot be created by hand.

The Image Converter tool creates a drawing sheet file which contains only one item: a poly polygon representing the source image. This drawing sheet file is appended to the current design, using the Append Existing Drawing Sheet command.

This command can be used to append any drawing sheet file, regardless of what items it contains. All items in the appended file will be added to the current design.

一度ロゴを取り込んだ後、移動や編集ウィンドウによるパラメータの編集が可能です。

ビットマップ(Bitmap)の追加

You can add an image bitmap using many common bitmap formats (PNG, JPEG, BMP, etc.).

  • 追加された画像ファイルは、300PPI(Pixel/Inch)として設定されます。

  • This value can be modified in the properties editor.

  • The actual size of the bitmap in the drawing sheet depends on this parameter.

  • Be aware that using higher definition values brings larger output files, and can have an effect on draw or plot time.

Bitmaps can be repeated but not rotated.