Std ViewScreenShot: Difference between revisions
Renatorivo (talk | contribs) (<translate>) |
mNo edit summary |
||
(39 intermediate revisions by 7 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
|||
<translate> |
<translate> |
||
{{GuiCommand|Name=Std ViewScreenShot|MenuLocation=Tools → Save picture...|Workbenches=All|SeeAlso=...}} |
|||
<!--T:18--> |
|||
{{Docnav |
|||
|[[Std_DlgParameter|DlgParameter]] |
|||
|[[Std_ViewLoadImage|ViewLoadImage]] |
|||
|[[Std_Tools_Menu|Std Tools Menu]] |
|||
|IconL=Std_DlgParameter.svg |
|||
|IconR=Std_ViewLoadImage.svg |
|||
|IconC=Freecad.svg |
|||
}} |
|||
<!--T:1--> |
|||
==== Synopsis ==== |
|||
{{GuiCommand |
|||
This command opens a dialog to save the current content of the 3D view to |
|||
|Name=Std ViewScreenShot |
|||
a file. It can save to various image formats. Additionally, you can change the |
|||
|MenuLocation=Tools → Save image... |
|||
aspect ratio and the resolution of the screen shot using the "Options" |
|||
|Workbenches=All |
|||
button to get access to more parameters. |
|||
|SeeAlso=[[Std_Print|Std Print]], [[Std_PrintPdf|Std PrintPdf]], [[Macro_Copy3DViewToClipboard|Macro Copy3DViewToClipboard]], [[Macro_Screen_Wiki|Macro Screen Wiki]], [[Macro_Snip|Macro Snip]] |
|||
}} |
|||
==Description== <!--T:17--> |
|||
This command can also use the image comment field of some image formats, like PNG or JPEG |
|||
to save [[MIBA]] information along with the picture. |
|||
<!--T:2--> |
|||
The '''Std ViewScreenShot''' command opens a dialog box to create an image file, a screenshot, from the active [[3D_view|3D view]]. |
|||
</translate> |
|||
==== Image formats ==== |
|||
[[Image:Save_picture.png|800px]] |
|||
FreeCAD uses the QT built-in image types and some QT plugins in the bin/imageformats directory |
|||
<translate> |
|||
to save pictures. So how many and what formats you can choose depends on your platform. |
|||
<!--T:19--> |
|||
{{Caption|The Save picture dialog box after pressing the Extended button}} |
|||
==== Dialog ==== |
|||
==Usage== <!--T:14--> |
|||
[[Image:Save_picture.png|550px]] |
|||
<!--T:15--> |
|||
# Select the {{MenuCommand|Tools → [[Image:Std_ViewScreenShot.svg|16px]] Save image...}} option from the menu. |
|||
# The Save image dialog box opens. |
|||
# 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== <!--T:16--> |
|||
===== Image Size ===== |
|||
The image size parameters are set to the screen size of the active 3D view. But you can change it to any value you like. Some OpenGL drivers don't allow renderings greater then 8000 pixels. It depends on your system. |
|||
===Image dimensions=== <!--T:20--> |
|||
With the four buttons you can change the aspect to a certain value. |
|||
<!--T:21--> |
|||
===== Image background ===== |
|||
# Select a standard size from the '''Standard sizes''' dropdown list. Or specify the '''Width''' and '''Height''' for a custom size. |
|||
With this combo box you can choose the background of the picture you make. |
|||
# 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. |
|||
* '''Current''' use the current view background (as chosen in the preferences) |
|||
* '''White''' creates a plain white background (for e.g. printings) |
|||
* '''Black''' plain black background |
|||
* '''Transparent''' creates a transparent background on image formats which support transparency |
|||
===Image properties=== <!--T:22--> |
|||
===== Comment ===== |
|||
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. |
|||
<!--T:23--> |
|||
# 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=== <!--T:24--> |
|||
<!--T:25--> |
|||
# 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. |
|||
# 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]. |
|||
==Notes== <!--T:26--> |
|||
<!--T:27--> |
|||
* 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== <!--T:28--> |
|||
<!--T:29--> |
|||
* The 3D view background can be changed in the preferences: {{MenuCommand|Edit → Preferences... → Display → Colors → Background color}}. See [[Preferences_Editor#Colors|Preferences Editor]]. |
|||
* To change the 3D view anti-aliasing: {{MenuCommand|Edit → Preferences... → Display → 3D view → Rendering → Anti-Aliasing}}. See [[Preferences_Editor#3D_View|Preferences Editor]]. |
|||
==Scripting== <!--T:30--> |
|||
<!--T:31--> |
|||
It is possible to create screenshots with python code. |
|||
==== Scripting ==== |
|||
It's also possible to save the screen by python: |
|||
</translate> |
</translate> |
||
{{Code|code= |
|||
<syntaxhighlight> |
|||
Gui.ActiveDocument.ActiveView.saveImage('C:/temp/test.png',1656,783,'Current') |
|||
}} |
|||
</syntaxhighlight> |
|||
<translate> |
<translate> |
||
This script makes a series of pictures of different sizes and from different |
|||
<!--T:32--> |
|||
points of view. The type of the camera, i.e. orthographic or perspective can also be changed. |
|||
This script saves a series of screenshots of different sizes and from different directions. The camera type, orthographic or perspective, is also changed. |
|||
</translate> |
</translate> |
||
{{Code|code= |
|||
<syntaxhighlight> |
|||
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") |
|||
# Creating images with different Views, Cameras and sizes |
|||
# close active document |
|||
for p in ['PerspectiveCamera','OrthographicCamera']: |
|||
App.closeDocument(App.ActiveDocument.Name) |
|||
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 |
|||
</syntaxhighlight> |
|||
App.closeDocument(App.ActiveDocument.Name) |
|||
{{clear}} |
|||
}} |
|||
<languages/> |
|||
<translate> |
|||
<!--T:33--> |
|||
{{Docnav |
|||
|[[Std_DlgParameter|DlgParameter]] |
|||
|[[Std_ViewLoadImage|ViewLoadImage]] |
|||
|[[Std_Tools_Menu|Std Tools Menu]] |
|||
|IconL=Std_DlgParameter.svg |
|||
|IconR=Std_ViewLoadImage.svg |
|||
|IconC=Freecad.svg |
|||
}} |
|||
</translate> |
|||
{{Std Base navi{{#translation:}}}} |
|||
{{Userdocnavi{{#translation:}}}} |
Latest revision as of 16:31, 14 April 2023
Std ViewScreenShot |
Menu location |
---|
Tools → Save image... |
Workbenches |
All |
Default shortcut |
None |
Introduced in version |
- |
See also |
Std Print, Std PrintPdf, Macro Copy3DViewToClipboard, Macro Screen Wiki, Macro Snip |
Description
The Std ViewScreenShot command opens a dialog box to create an image file, a screenshot, from the active 3D view.
The Save picture dialog box after pressing the Extended button
Usage
- Select the Tools → Save image... option from the menu.
- The Save image dialog box opens.
- Optionally press the Extended button to reveal an additional panel in the dialog box. For more information see Options.
- Optionally browse to the correct folder.
- Enter a filename and select the file type.
- Press the Save button to create the image file and close the dialog box.
Options
Image dimensions
- 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
- 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.
- 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
- Select the Insert MIBA option to add MIBA information to the file. Not all image formats support this.
- 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.
- 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)
Std Base
- File: New, Open, Close, Close All, Save, Save As, Save a Copy, Save All, Revert, Import, Export,Merge project, Project information, Print, Print preview, Export PDF, Recent files, Exit
- Edit: Undo, Redo, Cut, Copy, Paste, Duplicate selection, Refresh, Box selection, Box element selection, Select All, Delete, Send to Python Console, Placement, Transform, Alignment, Toggle Edit mode, Edit mode, Preferences
- View:
- Miscellaneous: Create new view, Orthographic view, Perspective view, Fullscreen, Bounding box, Toggle axis cross, Clipping plane, Texture mapping, Toggle navigation/Edit mode, Appearance, Random color, Workbench, Status bar
- Standard views: Fit all, Fit selection, Isometric, Dimetric, Trimetric, Home, Front, Top, Right, Rear, Bottom, Left, Rotate Left, Rotate Right
- Freeze display: Save views, Load views, Freeze view, Clear views
- Draw style: As is, Points, Wireframe, Hidden line, No shading, Shaded, Flat lines
- Stereo: Stereo red/cyan, Stereo quad buffer, Stereo Interleaved Rows, Stereo Interleaved Columns, Stereo Off, Issue camera position
- Zoom: Zoom In, Zoom Out, Box zoom
- Document window: Docked, Undocked, Fullscreen
- Visibility: Toggle visibility, Show selection, Hide selection, Select visible objects, Toggle all objects, Show all objects, Hide all objects, Toggle selectability, Toggle measurement, Clear measurement
- Toolbars: File, Edit, Clipboard, Workbench, Macro, View, Structure, Help
- Panels: Tree view, Property view, Selection view, Tasks, Python console, DAG view, Model, Report view
- Link navigation: Go to linked object, Go to the deepest linked object, Select all links
- Tree view actions: Sync view, Sync selection, Sync placement, Pre-selection, Record selection, Single document, Multi document, Collapse/Expand, Initiate dragging, Go to selection, Selection Back, Selection Forward
- Tools: Edit parameters, Save image, Load image, Scene inspector, Dependency graph, Project utility, Measure distance, Add text document, View turntable, Units calculator, Customize, Addon manager
- Macro: Macro recording, Macros, Recent macros, Execute macro, Attach to remote debugger, Debug macro, Stop debugging, Step over, Step into, Toggle breakpoint
- Help: Help, FreeCAD Website, Donate, Users documentation, Python scripting documentation, Automatic Python modules documentation, FreeCAD Forum, FreeCAD FAQ, Report a bug, About FreeCAD, What's This
User documentation
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub