| Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision |
| en:orx:config:settings_structure:orxviewport [2017/05/29 21:50 (7 years ago)] – external edit 127.0.0.1 | en:orx:config:settings_structure:orxviewport [2023/05/23 05:49 (12 months ago)] – Updated with new properties sausage |
|---|
| ===== orxVIEWPORT structure ===== | ===== orxVIEWPORT structure ===== |
| | |
| | Viewport module. Allows the creation and handling of viewports. Viewports are structures associated to cameras and used for rendering. |
| | |
| |
| ==== Summary ==== | ==== Summary ==== |
| |
| <code ini>[ViewportTemplate] | <code ini>[ViewportTemplate] |
| BackgroundColor = <vector> | AutoResize = <bool> |
| | BackgroundColor = <vector> | <WebColor> |
| BackgroundAlpha = <float> | BackgroundAlpha = <float> |
| Camera = CameraTemplate; | BlendMode = alpha|multiply|add|premul|none |
| RelativePosition = left | right | top | bottom | Camera = CameraTemplate |
| | FixedRatio = <float> |
| | KeepInCache = <bool> |
| | NoDebug = <bool> |
| | Position = center left|right top|bottom |
| Position = <vector> | Position = <vector> |
| RelativeSize = <vector> | |
| Size = <vector> | Size = <vector> |
| ShaderList = ShaderTemplate1#ShaderTemplate2 | ShaderList = ShaderTemplate1 # ... # ShaderTemplateN |
| TextureList = path/to/TextureFile # ... #path/to/TextureFileN | TextureList = path/to/TextureFile # ... #path/to/TextureFileN |
| | UseRelativeSize = <bool> |
| </code> | </code> |
| |
| |
| Here's a list of the available properties for an ''orxVIEWPORT'' structure: | Here's a list of the available properties for an ''orxVIEWPORT'' structure: |
| * ''BackgroundColor'': Defines which color will be used for clearing the viewport before rendering it. If not set, the viewport won't erase any part of other viewports previously rendered this frame if there are overlaps. | * ''AutoResize'': [Bool]; NB: Default value is true if no fixed size is given, false otherwise. It's only applicable to viewports with linked textures. If true, viewport's dimension, position and linked textures will be resized/updated upon video mode changes. |
| | * ''BackgroundColor'': Values are RGB from 0 to 255. Official HTML web color names are also supported. If not set, the viewport won't erase any part of other overlapping viewports that were previously rendered this frame. |
| * ''BackgroundAlpha'': If BackgroundColor is set, this value will be used as alpha; Defaults to 1.0; | * ''BackgroundAlpha'': If BackgroundColor is set, this value will be used as alpha; Defaults to 1.0; |
| | * ''BlendMode'': Default value is none, used only when active shaders are attached. |
| * ''Camera'': Template name of the camera that will be linked to this viewport. Each [[orxCAMERA|camera template]] will correspond to a unique camera at runtime. This means that if you use more than one viewport linked to the same camera, they will render the same content as seen by this camera. | * ''Camera'': Template name of the camera that will be linked to this viewport. Each [[orxCAMERA|camera template]] will correspond to a unique camera at runtime. This means that if you use more than one viewport linked to the same camera, they will render the same content as seen by this camera. |
| * ''RelativePosition'': Defines where the viewport will be placed in the main display. It should be a combination of two attributes. Ex.: top left to have your viewport in the top left corner. Its default value is ''top left''. | * ''FixedRatio'' = [Float]; NB: Only used when no camera is linked, otherwise the aspect ratio of the camera will act as ratio for the viewport. Defaults to none, ie. no fixed ratio is enforced. |
| | * ''KeepInCache'' = [Bool]; NB: If true, the associated textures will always stay in cache. Defaults to false. |
| | * ''NoDebug'': When set, no debug rendering will happen in this viewport. Defaults to false. |
| | * ''Position'': Defines where the viewport will be placed in the main display. It should be a combination of two attributes. Literal position (example: top left) or position in pixels, from the top left corner. Defaults to top left. |
| | * ''Size'': [Vector]; NB: Size in pixels; |
| * ''Position'': Defines an absolute position for the viewport in the main display, in pixel coordinates. This value is only used if none is provided for ''RelativePosition''. | * ''Position'': Defines an absolute position for the viewport in the main display, in pixel coordinates. This value is only used if none is provided for ''RelativePosition''. |
| * ''RelativeSize'': Defines the viewport size relatively to the main display's one, ie. (1, 1, 0) means that it will cover the full display. Its default value is (1, 1, 0) ((the Z component is ignored)). | * ''ShaderList'': Defines a list of shaders that will be executed every time this viewport is rendered. Shader will be activated immediately. Up to 4 shaders can be specified. By default, no shader is used. |
| * ''Size'': Defines the absolute viewport size, in pixels. This value is only used if none is provided for ''RelativeSize''. | * ''Size'': Defines the absolute viewport size, in pixels. This value is only used if none is provided for ''RelativeSize''. |
| * ''TextureList'': Defines a destination texture or list of textures where the viewport will be rendered. Its default value is the main display (ie. ''screen''). | * ''TextureList'': Textures used as destination when rendering that viewport; If the specified name doesn't refer to an existing texture, a texture of that name will be automatically created, matching the viewport's dimensions; Defaults to screen when not defined. |
| * ''ShaderList'': Defines a list of shaders that will be executed every time this viewport is rendered. Up to 4 shaders can be specified. By default, no shader is used. | * ''UseRelativeSize'': If true, the viewport size will be interpreted as relative to the underlying texture, using the [0.0 - 1.0] range on both x/y axes. Defaults to false. |
| |
| ==== Latest config settings for the Development Version ==== | ==== Latest config settings for the Development Version ==== |
| {{section>en:orx:config:developmentversion#&noheader&nofooter&noeditbutton}} | {{section>en:orx:config:developmentversion#&noheader&nofooter&noeditbutton}} |
| |
