File: viewport.rst

package info (click to toggle)
blender-doc 4.3-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 253,604 kB
  • sloc: python: 13,030; javascript: 322; makefile: 113; sh: 107
file content (164 lines) | stat: -rw-r--r-- 5,201 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164

********
Viewport
********

.. figure:: /images/editors_preferences_section_viewport.png

   Blender Preferences Viewport section.


Display
=======

.. _bpy.types.PreferencesView.show_object_info:

Text Info Overlay
   Object Info
      Display the active Object name and frame number at the top left of the 3D Viewport.

   .. _bpy.types.PreferencesView.show_view_name:

   View Name
      Display the name and type of the current view in the top left corner of the 3D Viewport.
      For example: "User Perspective" or "Top Orthographic".

.. _bpy.types.PreferencesView.show_playback_fps:

Playback Frame Rate (FPS)
   Show the frames per second screen refresh rate while an animation is played back.
   It appears in the top left of the 3D Viewport, displaying red if the frame rate set cannot be reached.

   .. _bpy.types.PreferencesView.playback_fps_samples:

   Frame Rate Samples
      Calculate the FPS displayed in the viewport based on an average of the current and previously displayed frames.
      A value of zero uses the number of frames in 1.0 second.

      - More samples represent the average FPS over a longer period of time,
        however sudden changes to performance result in a more gradual increase/decrease over time.
      - Fewer samples shows an FPS which more closely matches the actual performance,
        however the value may jitter - making the FPS difficult to comprehend.

.. _bpy.types.PreferencesView.gizmo_size:

Gizmo Size
   Diameter of the gizmo.

.. _bpy.types.PreferencesView.lookdev_sphere_size:

HDRI Preview Size
   Diameter of the HDRI sphere overlay.

.. _bpy.types.PreferencesView.mini_axis_type:

3D Viewport Axes
   :Interactive Navigation:
      Display the axis as an interactive gizmo.
      Click sets the viewport to display along this axis and dragging orbits the view.
   :Simple Axes:
      Display simple, less intrusive axis in the viewport.

      .. _bpy.types.PreferencesView.mini_axis_brightness:

      Brightness
         How vivid the colors of the simple axis are.
   :Off:
      Disables the viewport axis.

.. _bpy.types.PreferencesView.gizmo_size_navigate_v3d:

Size
   Diameter of the *3D Viewport Axis* widget.

.. _bpy.types.PreferencesView.use_fresnel_edit:

Fresnel -- Edit Mode
      Enable a fresnel effect on edit mesh overlays.
      It improves shape readability of very dense meshes, but increases eye fatigue when modeling lower poly.


.. _prefs-system-multisampling:

Quality
=======

.. _bpy.types.PreferencesSystem.viewport_aa:

Viewport Anti-Aliasing
   Control the :term:`Anti-Aliasing` for higher quality rendering.

.. _bpy.types.PreferencesSystem.use_overlay_smooth_wire:

Smooth Wires
   Overlay
      Display overlays with smooth wire, without this wires will be rendered aliased.
      To increase the visibility you can disable this for Edit Mode specificity (see below),
      since edges do not blend into other shaded regions.

   .. _bpy.types.PreferencesSystem.use_edit_mode_smooth_wire:

   Edit Mode
      Display smooth wire in Edit Mode, without this wires will be rendered aliased.


Textures
========

.. _bpy.types.PreferencesSystem.gl_texture_limit:

Limit Size
   Limit the maximum resolution for pictures used in textured display to save memory.
   The limit options are specified in a square of pixels
   (e.g: the option 256 means a texture of 256×256 pixels). This is useful for game engineers,
   whereas the texture limit matches paging blocks of the textures in the target graphic card memory.

.. _bpy.types.PreferencesSystem.anisotropic_filter:

Anisotropic Filtering
   Sets the level of anisotropic filtering.
   This improves the quality of textures that are rendered at the cost of performance.

.. _bpy.types.PreferencesSystem.gl_clip_alpha:

Clip Alpha
   Clip alpha below this threshold in the 3D Viewport.
   Note that, the default is set to a low value to prevent issues on some GPUs.

.. _bpy.types.PreferencesSystem.image_draw_method:

Image Display Method
   Method to render images; the following options are supported:

   :Automatic:
      Automatically use *GLSL* which runs on the GPU for performance but falls back to
      the CPU for large images which might be slow when loaded with the GPU.
   :2D Texture:
      Uses CPU for display transform and render images as a 2D texture.
   :GLSL:
      Fastest method using GLSL for display transform and render images as a 2D texture.


Selection
=========

.. _bpy.types.PreferencesSystem.use_select_pick_depth:

GPU Depth Picking
   This option uses an alternative method of picking which uses depth information to select the front-most elements.
   It is only used for selecting with the cursor (not box select, lasso, circle select, etc.).

   Performance varies depending on your OpenGL hardware and drivers.


Subdivision
===========

.. _bpy.types.PreferencesSystem.use_gpu_subdivision:

GPU Subdivision
   Under certain circumstances, the GPU will be used to subdivide a mesh with a
   :doc:`Subdivision Surface modifier </modeling/modifiers/generate/subdivision_surface>`.
   This typically results in increased subdivision performance.

   This feature is not supported on Qualcomm GPUs on Windows