Std ViewScreenShot/ja: Difference between revisions

From FreeCAD Documentation
No edit summary
(Updating to match new version of source page)
 
(14 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{GuiCommand/jp|Name=Std_ViewScreenShot|MenuLocation=Tools -> Save picture...|Workbenches=All|SeeAlso=...}}


{{Docnav
|[[Std_DlgParameter|DlgParameter]]
|[[Std_ViewLoadImage|ViewLoadImage]]
|[[Std_Tools_Menu|Std Tools Menu]]
|IconL=Std_DlgParameter.svg
|IconR=Std_ViewLoadImage.svg
|IconC=Freecad.svg
}}


<div class="mw-translate-fuzzy">
{{GuiCommand/ja
|Name=Std_ViewScreenShot
|Name/ja=Std_ViewScreenShot
|MenuLocation=Tools -> Save picture...
|Workbenches=All
|SeeAlso=
}}
</div>

==Description==

<div class="mw-translate-fuzzy">
==== 概要 ====
==== 概要 ====


Line 8: Line 28:
このダイアログでは様々な画像フォーマットで保存を行うことができます。
このダイアログでは様々な画像フォーマットで保存を行うことができます。
さらにパラメーターにアクセスするための"Options"ボタンを使ってスクリーンショットの
さらにパラメーターにアクセスするための"Options"ボタンを使ってスクリーンショットの
アスペクト比や解像度を変更することも可能です。
アスペクト比や解像度を変更することも可能です。
</div>


[[Image:Save_picture.png|800px]]
This command can also use the image comment field of some image formats, like PNG or JPEG
{{Caption|The Save picture dialog box after pressing the Extended button}}
to save [[MIBA]] information along with the picture.


==Usage==


# Select the {{MenuCommand|Tools → [[Image:Std_ViewScreenShot.svg|16px]] Save image...}} option from the menu.
==== 画像フォーマット ====
# The Save image dialog box opens.
FreeCADは画像保存のためにQTに組み込まれた画像タイプとbin/imageformatsディレクトリにある一部のQTプラグインを使用しています。
# Optionally press the {{Button|Extended}} button to reveal an additional panel in the dialog box. For more information see [[#Options|Options]].
従って選択できるフォーマットの種類と数はあなたの使用しているプラットフォームに依存します。
# Optionally browse to the correct folder.
# Enter a filename and select the file type.
==== ダイアログ ====
# Press the {{Button|Save}} button to create the image file and close the dialog box.


==Options==
[[Image:Save_picture.png|550px]]


===Image dimensions===
[[Image:Save_picture.png|550px]]


# Select a standard size from the '''Standard sizes''' dropdown list. Or specify the '''Width''' and '''Height''' for a custom size.
# Optionally press an '''Aspect ratio''' button to set the width-to-height ratio of the image. If the '''Width''' input box has the focus the height of the image will change and vice versa.


===== 画像サイズ =====
===Image properties===
画像サイズパラメーターはアクティブな3Dビューのスクリーンサイズに設定されますが任意の値に変更することができます。一部のOpenGLのドライバーでは8000ピクセルを超えたレンダリングができないことがあります。これは使用しているシステムによって変わります。


# Select an option from the '''Background''' dropdown list:
四つのボタンを使用してアスペクトを特定の値に変更することが可能です。
#* {{Value|Current}} This option uses the background of the 3D view.
#* {{Value|White}}
#* {{Value|Black}}
#* {{Value|Transparent}} Not all image formats support transparency.
# Select an option from the '''Creation method''' dropdown list:
#* {{Value|Offscreen (New)}} This is the default method. This method supports [https://en.wikipedia.org/wiki/Multisample_anti-aliasing anti-aliasing]. ''Technical information: The most important classes for this method are Qt's QOffscreenSurface and QOpenGLFramebufferObject.''
#* {{Value|Offscreen (Old)}} This method does not work on many modern Linux systems as it relies on the graphics driver. This method does not support anti-aliasing. ''Technical information: This is a real off-screen rendering method that only uses functions from the Coin3d library.''
#* {{Value|Framebuffer (custom)}} This method supports anti-aliasing. ''Technical information: If anti-aliasing is off, this method reads the image directly from the graphics renderer, else it renders to a framebuffer and gets the image from there. The key part of this method is Qt's QOpenGLFramebufferObject class.''
#* {{Value|Framebuffer (as is)}} This method uses the same techniques as '''Framebuffer (custom)'''. It also supports anti-aliasing but has some limitations related to custom sizes and always uses the current background of the 3D view.


===== 画像の背景 =====
===Image comment===


# Select the {{RadioButton|TRUE|Insert MIBA}} option to add [[MIBA]] information to the file. Not all image formats support this.
このコンボボックスを使用して作成する画像の背景を選択することが可能です。
# Or select the {{RadioButton|TRUE|Insert comment}} option and type a comment in the text field to embed a comment in the file. Not all image formats support this.
* '''Current''' (ユーザー設定で選択されている)現在のビューの背景を使用します
# Check the {{CheckBox|TRUE|Add watermark}} checkbox to add a watermark. The watermark is placed in the lower left corner of the image and consists of the FreeCAD logo and name above the main FreeCAD URL: [http://www.freecadweb.org www.freecadweb.org].
* '''White''' 白一色の背景を作成します(例えば印刷時に使用します)
* '''Black''' 黒一色の背景
* '''Transparent''' 透過色をサポートしている画像フォーマットで透過背景を作成します


===== Comment =====
==Notes==
Some image formats can transport a comment along the picture. In case you choose one of this formats you can insert a comment or use the comment field for the [[MIBA]] information.


* The number of available image file formats may vary depending on your OS.
==== スクリプト処理 ====
* Some OpenGL drivers don't allow renderings above a certain maximum size.


==Preferences==
Pythonによってスクリーンを保存することもできます:


* The 3D view background can be changed in the preferences: {{MenuCommand|Edit → Preferences... → Display → Colors → Background color}}. See [[Preferences_Editor#Colors|Preferences Editor]].
Gui.ActiveDocument.ActiveView.saveImage('C:/temp/test.png',1656,783,'Current')
* To change the 3D view anti-aliasing: {{MenuCommand|Edit → Preferences... → Display → 3D view → Rendering → Anti-Aliasing}}. See [[Preferences_Editor#3D_View|Preferences Editor]].


==Scripting==
このスクリプトは異なるサイズ、異なる始点で複数の画像を作成します。
カメラのタイプ、つまり正投影か透視投影かを変更することもできます。


It is possible to create screenshots with python code.
import Part,PartGui

# テスト用パーツを読み込み
{{Code|code=
Part.open("C:/Documents and Settings/jriegel/My Documents/Projects/FreeCAD/data/Blade.stp")
Gui.ActiveDocument.ActiveView.saveImage('C:/temp/test.png',1656,783,'Current')
OutDir = 'c:/temp/'
}}

This script saves a series of screenshots of different sizes and from different directions. The camera type, orthographic or perspective, is also changed.

{{Code|code=
import Part, PartGui
# Loading test part
Part.open('C:/Documents and Settings/jriegel/My Documents/Projects/FreeCAD/data/Blade.stp')
OutDir = 'C:/temp/'
# Creating images with different Views, Cameras and sizes
# 異なるビュー、カメラ、サイズで画像を作成
for p in ["PerspectiveCamera","OrthographicCamera"]:
for p in ['PerspectiveCamera','OrthographicCamera']:
Gui.SendMsgToActiveView(p)
Gui.SendMsgToActiveView(p)
for f in ["ViewAxo","ViewFront","ViewTop"]:
for f in ['ViewAxo','ViewFront','ViewTop']:
Gui.SendMsgToActiveView(f)
Gui.SendMsgToActiveView(f)
for x,y in [[500,500],[1000,3000],[3000,1000],[3000,3000],[8000,8000]]:
for x,y in [[500,500],[1000,3000],[3000,1000],[3000,3000],[8000,8000]]:
Gui.ActiveDocument.ActiveView.saveImage(OutDir + "Blade_" + p +"_" + f + "_" + `x` + "_" + `y` + ".jpg",x,y,"White")
Gui.ActiveDocument.ActiveView.saveImage(OutDir + 'Blade_' + p +'_' + f + '_' + `x` + '_' + `y` + '.jpg',x,y,'White')
Gui.ActiveDocument.ActiveView.saveImage(OutDir + "Blade_" + p +"_" + f + "_" + `x` + "_" + `y` + ".png",x,y,"Transparent")
Gui.ActiveDocument.ActiveView.saveImage(OutDir + 'Blade_' + p +'_' + f + '_' + `x` + '_' + `y` + '.png',x,y,'Transparent')

# Close active document
# アクティブなドキュメントを閉じます
App.closeDocument(App.ActiveDocument.Name)
App.closeDocument(App.ActiveDocument.Name)
}}
<syntaxhighlight>

Gui.ActiveDocument.ActiveView.saveImage('C:/temp/test.png',1656,783,'Current')

</syntaxhighlight>
{{Docnav
This script makes a series of pictures of different sizes and from different
|[[Std_DlgParameter|DlgParameter]]
points of view. The type of the camera, i.e. orthographic or perspective can also be changed.
|[[Std_ViewLoadImage|ViewLoadImage]]
<syntaxhighlight>
|[[Std_Tools_Menu|Std Tools Menu]]
import Part,PartGui
|IconL=Std_DlgParameter.svg
# loading test part
|IconR=Std_ViewLoadImage.svg
Part.open("C:/Documents and Settings/jriegel/My Documents/Projects/FreeCAD/data/Blade.stp")
|IconC=Freecad.svg
OutDir = 'c:/temp/'
}}
# creating images with different Views, Cameras and sizes
for p in ["PerspectiveCamera","OrthographicCamera"]:
Gui.SendMsgToActiveView(p)
for f in ["ViewAxo","ViewFront","ViewTop"]:
Gui.SendMsgToActiveView(f)
for x,y in [[500,500],[1000,3000],[3000,1000],[3000,3000],[8000,8000]]:
Gui.ActiveDocument.ActiveView.saveImage(OutDir + "Blade_" + p +"_" + f + "_" + `x` + "_" + `y` + ".jpg",x,y,"White")
Gui.ActiveDocument.ActiveView.saveImage(OutDir + "Blade_" + p +"_" + f + "_" + `x` + "_" + `y` + ".png",x,y,"Transparent")
# close active document
App.closeDocument(App.ActiveDocument.Name)


{{Std Base navi{{#translation:}}}}
</syntaxhighlight>
{{Userdocnavi{{#translation:}}}}
{{clear}}

Latest revision as of 16:32, 14 April 2023

Std_ViewScreenShot

メニューの場所
Tools -> Save picture...
ワークベンチ
All
デフォルトのショートカット
None
バージョンで導入
-
も参照してください
None

Description

概要

このコマンドは現在の3Dビューの内容をファイルに保存するためのダイアログを開きます。 このダイアログでは様々な画像フォーマットで保存を行うことができます。 さらにパラメーターにアクセスするための"Options"ボタンを使ってスクリーンショットの アスペクト比や解像度を変更することも可能です。

The Save picture dialog box after pressing the Extended button

Usage

  1. Select the Tools → Save image... option from the menu.
  2. The Save image dialog box opens.
  3. Optionally press the Extended button to reveal an additional panel in the dialog box. For more information see Options.
  4. Optionally browse to the correct folder.
  5. Enter a filename and select the file type.
  6. Press the Save button to create the image file and close the dialog box.

Options

Image dimensions

  1. Select a standard size from the Standard sizes dropdown list. Or specify the Width and Height for a custom size.
  2. Optionally press an Aspect ratio button to set the width-to-height ratio of the image. If the Width input box has the focus the height of the image will change and vice versa.

Image properties

  1. Select an option from the Background dropdown list:
    • Current This option uses the background of the 3D view.
    • White
    • Black
    • Transparent Not all image formats support transparency.
  2. Select an option from the Creation method dropdown list:
    • Offscreen (New) This is the default method. This method supports anti-aliasing. Technical information: The most important classes for this method are Qt's QOffscreenSurface and QOpenGLFramebufferObject.
    • Offscreen (Old) This method does not work on many modern Linux systems as it relies on the graphics driver. This method does not support anti-aliasing. Technical information: This is a real off-screen rendering method that only uses functions from the Coin3d library.
    • Framebuffer (custom) This method supports anti-aliasing. Technical information: If anti-aliasing is off, this method reads the image directly from the graphics renderer, else it renders to a framebuffer and gets the image from there. The key part of this method is Qt's QOpenGLFramebufferObject class.
    • Framebuffer (as is) This method uses the same techniques as Framebuffer (custom). It also supports anti-aliasing but has some limitations related to custom sizes and always uses the current background of the 3D view.

Image comment

  1. Select the Insert MIBA option to add MIBA information to the file. Not all image formats support this.
  2. Or select the Insert comment option and type a comment in the text field to embed a comment in the file. Not all image formats support this.
  3. Check the Add watermark checkbox to add a watermark. The watermark is placed in the lower left corner of the image and consists of the FreeCAD logo and name above the main FreeCAD URL: www.freecadweb.org.

Notes

  • The number of available image file formats may vary depending on your OS.
  • Some OpenGL drivers don't allow renderings above a certain maximum size.

Preferences

  • The 3D view background can be changed in the preferences: Edit → Preferences... → Display → Colors → Background color. See Preferences Editor.
  • To change the 3D view anti-aliasing: Edit → Preferences... → Display → 3D view → Rendering → Anti-Aliasing. See Preferences Editor.

Scripting

It is possible to create screenshots with python code.

Gui.ActiveDocument.ActiveView.saveImage('C:/temp/test.png',1656,783,'Current')

This script saves a series of screenshots of different sizes and from different directions. The camera type, orthographic or perspective, is also changed.

import Part, PartGui
# Loading test part
Part.open('C:/Documents and Settings/jriegel/My Documents/Projects/FreeCAD/data/Blade.stp')
OutDir = 'C:/temp/'
 
# Creating images with different Views, Cameras and sizes
for p in ['PerspectiveCamera','OrthographicCamera']:
    Gui.SendMsgToActiveView(p)
    for f in ['ViewAxo','ViewFront','ViewTop']:
        Gui.SendMsgToActiveView(f)
        for x,y in [[500,500],[1000,3000],[3000,1000],[3000,3000],[8000,8000]]:
            Gui.ActiveDocument.ActiveView.saveImage(OutDir + 'Blade_' + p +'_' + f + '_' + `x` + '_' + `y` + '.jpg',x,y,'White')
            Gui.ActiveDocument.ActiveView.saveImage(OutDir + 'Blade_' + p +'_' + f + '_' + `x` + '_' + `y` + '.png',x,y,'Transparent')

# Close active document
App.closeDocument(App.ActiveDocument.Name)