Jholsenback: image format changes

2011-06-15T16:27:42Z

image format changes

Show changes

Jholsenback: heading title correction

2011-01-10T14:51:38Z

heading title correction

Jholsenback: removed quotes from the heading title

2011-01-10T13:13:42Z

removed quotes from the heading title

Jholsenback: cleanup

2010-12-14T01:37:48Z

cleanup

Show changes

Jholsenback: heading changes

2010-03-27T18:41:58Z

heading changes

Show changes

Jholsenback: corrected case sensitive class id

2009-05-06T13:33:45Z

corrected case sensitive class id

Jholsenback: Protected "Documentation:Mac OS Section 5" [edit=sysop:move=sysop]

2009-03-10T18:24:57Z

Protected "Documentation:Mac OS Section 5" [edit=sysop:move=sysop]

Jholsenback: 1 revision(s)

2009-03-10T18:22:21Z

1 revision(s)

WikiSysop: /* Actions Pane */

2009-03-08T11:37:47Z

Actions Pane

New page

<table width=100% border=1 cellspacing=0 cellpadding=5>
<tr><td width=100% bgcolor=#FFEEEE>
This document is protected, so submissions, corrections and discussions should be held on this documents [[Documentation_Talk:Mac OS Section 5|talk]] page.
</td></tr>
</table>
 

===Dialogs===

===Preferences Dialog===
This modeless dialog box is displayed when the user selects the
"Edit: Preferences..." menu item. You can set the amount of
CPU-time POV-Ray uses for rendering via a popup menu, and set paths to
search for include files that will be used for every scene file in
addition the scene specific files. Further you can specify how to be
notified after POV-Ray has finished rendering, using a dialog and/or a
beep sound. The selections you make here are saved in the program's
preferences file, so that these preferences are remembered between runs
of POV-Ray.

===General Pane===
This pane contains settings for the POV-Ray application features like
the speed it will render, or the render engine core being used.
[[Image:MacImgGeneralprefs.gif|General Preferences Dialog Pane]]
===Fast Preview Mode===
If fast Preview Mode is enabled, the preview window will only be
updated for each line that has been rendered. If it is off, the preview
window will show each pixel being rendered, which will slow down
rendering of very simple scene (that take just a few secvonds to render)
as the overhead of drawing each pixel in particular on Mac OS X is
significant.
For scenes that take several hours to render this option makes no
significant difference. Expect rendering to take an addition ten to
twenty seconds (depending of preview image size) regardless of scene
complexity if Fast Preview Mode is turned off.
===Fast Functions===
Enable this option to turn on the POV-Ray Mac just-in-time compiler
for the "function" keyword. It turns equations in functions to
native PowerPC code executed directly instead of interpreting the
equations. This will for example increase rendering speed of
isosurfaces. However, certain statistics will not be gathered if Fast
Functions is enabled and the just-in-time compilation does slow down
parsing a tiny bit and does increase memory consumption.

===Background Rendering===
By default POV-ray rendering takes place in the background (in a
separate thread) and as such leaves the user interface of POV-Ray
responsive. However, especially on Mac OS 8 and 9 on slow Macs with
little memory and virtual memory enabled, tuurning this option off may
increase rendering speed. However, disabling Background Rendering will
make POV-Ray less responsive and on Mac OS X it may appear as if it has
crashed due to Mac OS X automatically disabling window updates of
unresponsive applications. On Mac OS 8 and 9 the whole system will be
slow in responding when Background Rendering is disabled!

===Use Temporary Memory===
On Mac OS 8 and9 each application has a limited amount of memory
assigned to it. Enable this option such that wehn rendering POV-Ray will
aquire additional memory from the operating system when rendering,
regardless of the application memory size you set for the POV-Ray
application.
On Mac OS X applications may always use all available
memory and as such, this option is disabled when running on Mac OS
X!

===Render Engine===
The popup menu allows you to select which renderer will be used to
render your images. You may select different versions optimised for
different processors. Versions that cannot run on your system are shown,
but cannot be selected.
Further, this menu may contain render engines of unofficial versions
or custom compiles of POV-Ray that you installed by copying them into
the "POV-Ray Cores" folder inside the POV-Ray application
folder. Note that this folder will only be searched when you start the
POV-Ray applications, and if you added or removed render engines from
the folder, you will need to restart the POV-Ray application in order to
see those changes!

===Editor Pane===
This pane contains all settings that will alter the display of the
source file text editor.
[[Image:MacImgEditorprefs.gif|Editor Preferences Dialog Pane]]
===Font===
You can choose the font you wish the text to be displayed with.

===Size===
This will set the size of the font the text will be displayed
with.
===Tab Size===
Tabs are an important feature to make scenes more readable and they
will give scene source display a better structure. You can set how many
spaces to the right the text will be moved when it contains a tab
character with this setting.
===Auto Indent===
Turn this feature on if you want the next line to begin already
indented, directly under your current line. Turn this off to force the
next line to always start at the far left side of the window, regardless
of your current indenting.
===Syntax Coloring===
This group-box allows you display the scene source text with
different colors for different scene description language elements.
Simply click on a color and the standard color picker dialog will
appear. You can set the color to whatever you like. Of course, since the
background color is white, you should not set any text elements to
white.
===Symbol Coloring===
This group-box allows you display the scene source text with
different colors for different declared values and macros. This feature
is able to search most include files you use in your scene as well.
Simply click on a color and the standard color picker dialog will
appear. You can set the color to whatever you like. Of course, since the
background color is white, you should not set any text elements to
white.
Note: Symbol coloring is only updated when you save the
scene file to disc because it would be too slow updating while
typing.
===Actions Pane===
This pane contains settings for actions the POV-Ray application takes
on startup or termination.
[[Image:MacImgActionsprefs.gif|Actions Preferences Dialog Pane]]
===Startup Actions===
The "Auto-load template menu" option is disabled because
the Template menu is always loaded in POV-Ray 3.5. You may use the
"Show open dialog" option so POV-Ray shows an Open Files
dialog when you start it.
===Startup and termination script actions===
You may select scripts that are executed whenever POV-Ray is started
or terminated. This is useful for example to cleanup some rendered
images or open certain scene files on ever startup.

===Actions after all jobs finished===
This groupbox allows you to set what actions will be performed when
rendering is finished. You can select a sound to be played and choose
between no additionally notification, a notification by dialog. Using
the script options you may create features similar to previous versions
of POV-Ray like quitting POV-Ray or shutting down your computer.
===Files Pane===
This pane contains settings for handling of files like which file
types can be rendered or which application will be selected as default
to open specific images files generated by POV-Ray.
[[Image:MacImgFilesprefs.gif|Files Preferences Dialog Pane]]
===Allow rendering of ".pov" files only===
With this option is useful when you frequently edit include and other
files and do not want to "render" those files by accident.
===Application creator codes for output files===
You may select a specific application that will be made the default
to open images of the listed type with these popup menus.
===Scenes Pane===
In this pane you may select include paths and other settings for
scene files.
[[Image:MacImgScenesprefs.gif|Scenes Preferences Dialog Pane]]
===Global Include Paths===
These include paths will be used with every scene you render. This is
useful so you do not always have to add an include path to the default
include files folder, which contains files such as
"colors.inc".
===Default Render Settings Set===
If you open scene files for the first time and those scene files do
not have any render settings POV-Ray will use the set you specify with
this popup menu.
===Render Settings Dialog===
This modeless dialog box is displayed when the user selects the
"Edit: Render Settings..." menu item. The user can set almost
all of the POV-Ray command-line flags from this dialog. This information
is saved in the currently open scene description file, so it is
remembered between runs.
You can switch between the panes using the tab control near the top.
You may switch back and forth between any or all of the panes and
changing things. You can quickly cycle between the tabs by holding down
the control and command keys and pressing the left arrow or right arrow
key.
===Scene Pane===
This pane contains settings for how the input scene file will be read
and if a preview will be displayed.
[[Image:MacImgScenesettings.gif|Scene Settings Dialog Pane]]
===Command-Line===
POV-Ray is controlled via command-line options on other platforms. In
order to specify options not available in the Render Settings, such as
INI files or stream redirection, you may enter any command-line
arguments in this text field. Be aware that the command-line options
override corresponding Render Settings dialog options.

===Language===
This popup menu contains the settings for the "+MV" Max
Version command line switch for POV-Ray. This determines what version of
syntax POV-Ray will initially expect when parsing a scene. If this is an
older version of a scene file, you can set its version here. You can
also insert a "#version" directive in the scene file itself,
which is preferred, since it will then be carried across to other
platforms.
===Show Preview===
This will show the preview window with the rendered image. When you
deactivate this option you cannot see the rendered image until it is
completly rendered. In order to see the image then, you have to open it
with another application. Generaly deactivating is only useful for the
long, final rendering of an image because then deactivating the preview
will speed up things a little bit (on fast Macs less than 1%).
===Mosaic Preview===
The checkbox activates mosaic preview. The pair of sliders set the
behavior of Mosaic Preview mode. Mosaic Preview is a method of rendering
that passes over the image multiple times, first rendering it in large
blocks, then finer blocks, until it finally passes over it rendering a
pixel at a time. Its algorithm is careful to only render pixels it
hasn't rendered in the previous pass, so this is not too much slower
than a regular scanline-by-scanline render. This is best used for quick
preview renders, not for final anti-aliased renders. It will quickly
give you a rough full-screen image, telling you if your camera and
lights are close. You can stop the render, change the scene and
re-render much more quickly than if you had to wait for a portion of
your scene to show up.
If mosaic preview is activated the preview window is rendered in
Mosaic Preview mode. The sliders set the size of the mosaic. The
"Start" mosaic size has to be larger than the "End"
mosaic size. This will automatically insured when you change the silders
position.
===File Specific Include Paths===
These include paths will be used with this particular scene. This
allows you to use a set of different include paths for each scene
without having to change the paths for every scene each time.
===Quality Pane===
This pane contains settings for the quality of the rendering process.
Here you can turn on/off Anti- aliasing and set theoverall quality
(+Qnn) of the render.
[[Image:MacImgQualitysettings.gif|Quality Settings Dialog Pane]]
===Render Quality===
This groupbox allows you to set the quality of the rendered image.
Use the slider to set the basic quality setting. The text below it will
show the features offered by the setting. Moving the slider position to
the right will increase the quality and rendering time will increase as
well.
The image at the right will show a preview of the quality
settings.
===Anti-Aliasing===
Turn this on to enable softening of the otherwise harsh jagged edges
of computer rendered scenes. This is best used for the final rendering
of your image. Sampling method "Adaptive" is a little faster
and gives good results at recursion depth 1 or 2. Turning on Jitter will
make the scene a little more blurry, but can often soften jaggies and
herringbone interference patterns even more.
===Optimization Pane===
This pane contains settings for the optimization during the rendering
process. Here you can turn on/off various flags that try to optimize
bounding and buffering to speed up rendering, often at the cost of
increased RAM memory usage.
[[Image:MacImgOptisettings.gif|Optimization Settings Dialog Pane]]
===Auto-Bounding===
This changes the bounding slab object threshold switch (+MBnn), or
turns off auto-bounding altogether. Use the slider to set the
threshold.
===Ignore any "bounded_by" in scene===
Early versions of POV-Ray had no automatic bounding to speed up
rendering. Users had to manually creating bounding boxes to speed up
rendering. For most scenes using the automatic bounding is faster and
you should keep this setting on, but some old scenes may expect the old
bounding mechanism.
===Split Unions===
Early versions of POV-Ray had no automatic bounding and handled
unions a little bit different. Some scene files expect the old way
unions could be used for and will not work with this option
activated.
===Use Light Buffer===
Turn this on to speedup rendering. You only need to deactivate this
option is when it does not work as expected.
===Use Vista Buffer===
Turn this on to speedup rendering. You only need to deactivate this
option is when it does not work as expected.
===Draw Vista Buffers===
Turn this on to draw the vista buffers created. This is for your
interest and for debugging only, it has no real use.
===Output Pane===
This pane contains settings for the output size and file format of
the final image. It also allows setting the partial row and column
values, if a sub-square of the image is to be rendered.
[[Image:MacImgOutputsettings.gif|Output Settings Dialog Pane]]
===Image Size===
This popup menu contains some of the more common settings for the
image's width and height, in pixels. Beside each value is a description
of what screens use that setting. When you select one of these items,
the associated height and width are set to the corresponding values. If
you manually type in a width and height that matches one of these
presets, then the matching item on this popup menu will be checkmarked
the next time you select the popup. If no predefined menu item matches
the specified size the "User Defined" menu item is set to the
current values.
===Partial Image===
This groupbox allows you to render only a portion of the image. You
can set these values through the selection mode of the preview window as
well, but you have to set the values before rendering in order to be
used.
===Save Image As===
This popup menu lets you choose to write to native Mac PICT format,
Targa, PNG, or Unix PPM formats. It also lets you write to a QuickTime
movie file, most useful if you are also turning on animation.
===Bits per color===
These radiobuttons will set the bits per color of certain file
formats. Note that this confusing buttons really mean bits per color
component, like red or green or blue, so 8 means 8 bits (a byte) for
red, a byte for green, and a byte for blue, totalling a (8+8+8) 24 bit
image. Note also, setting the bits per color for PICT to 5 will force
PICTs to be "thousands" of colors instead of
"millions".
===Add Alpha-Channel===
This adds an alpha-channel to the image. An alpha-channel is a fourth
color compontent specifying how dense the image will be drawn over a
background. This is similar to painting on a transpartent film. The more
ink is on the film, the less background can be seen through it. Note
that only advanced applications like PhotoShop can display an image
properly. The shareware "GraphicConverter" can show the
separate alpha-channel as well.
===Compression===
Some image formats allow to enable/disable compression. Use this item
to activate compression of the image. This will save disk space for
large images.
===Set Compression===
For the Mac OS Picture and QuickTime Movie formats you can set the
advanced QuickTime compression settings in the standard QuickTime
compression settings dialog.
===Save Histogram As===
This feature is not yet available.
===Animation Pane===
This pane lets the user set up initial, final, and number of frames
for doing multiple frame animations. This sets up POV-Ray to do multiple
images, each time sending a slightly different "+K" value to
the POV-Ray engine. You need to turn on the checkbox "Turn on clock
Animation" to make animation take effect.
[[Image:MacImgAnimationsettings.gif|Animation Settings Dialog Pane]]
===Frame Number===
This is just a reference number which counts the number of frames (or
images) to generate. It starts at one, and increments for each frame.
This number is not accessable inside your scene files, it is simply an
external counter of image frames. The overall span of frames for an
animation goes from INITIAL to FINAL. The actual frames that will be
rendered from that will be a subset, from START AT to END AT:
Initial - This is a constant low bound for the frame counter. It is
always one.
Start At - This is the first frame number to start generating images
for. It can be any integer number from "Initial" to "End
at". You might want to set this to something higher than
"Initial" if you want to render some subset of overall
animation frames (e.g., you have several machines simultaneously
rendering different parts of the animation sequence.)
End At - This is the last frame number to generate images for. It can
be any integer number from "Start at"to "Final".
Final - This is the high bound for the frame counter. It is the total
number of frames that should be generated for the scene. This is used to
calculate the span of clock values.
===Clock Value===
This is a variable passed into POV-Ray, which can be used as a
dynamically changing animation variable (clock) in a scene file (the
"+Knn" parameter.)
Initial - This is the clock value at frame #1. It must be different
than the "Final" clock value, but otherwise may be any
floating point value.
Start At - This is the displayed clock value at the "Start
At" frame value.
End At - This is the displayed clock value at the "End At"
frame value.
Final - This is the clock value at the "Final" frame #. It
must be different than the "Initial" clock value, but
otherwise may be any floating point value, higher or lower than
Initial.
===Field Rendering===
Activate this option for rendering only the specified scanlines of an
image. This is useful for animations on interlaced display, e.g. TVs.
The radiobuttons let you choose which scanline to start on.
===Actions Pane===
This pane contains settings for actions to be taken before or after
rendering a scene or individual frame. This is useful for scene cleanup
or making sure all needed files are in place.
[[Image:MacImgActionssettings.gif|Actions Settings Dialog Pane]]

 
<table width=100% border=0 cellspacing=0 cellpadding=5>
<tr><td width=50% bgcolor=#EEEEEF>
[[Documentation:Mac OS Section 4#Templates Window|Templates Window]]</td>
<td width=50% bgcolor=#EEEEEF align=right>
[[Documentation:Mac OS Section 6#Command-Line Options|Command-Line Options]]</td></tr>
</table>


 
<table width=100% border=1 cellspacing=0 cellpadding=5>
<tr><td width=100% bgcolor=#FFEEEE>
This document is protected, so submissions, corrections and discussions should be held on this documents [[Documentation_Talk:Mac OS Section 5|talk]] page.
</td></tr>
</table>

@@ Line 250: / Line 250: @@
 turns off auto-bounding altogether. Use the slider to set the
 threshold.</p>
-=====Ignore any "bounded_by" in scene=====
+=====Ignore any bounded_by in scene=====
 <p>Early versions of POV-Ray had no automatic bounding to speed up
 rendering. Users had to manually creating bounding boxes to speed up
@@ Line 256: / Line 256: @@
 you should keep this setting on, but some old scenes may expect the old
 bounding mechanism.</p>
 =====Split Unions=====
 <p>Early versions of POV-Ray had no automatic bounding and handled

@@ Line 141: / Line 141: @@
 to open specific images files generated by POV-Ray.</p>
 <p>[[Image:MacImgFilesprefs.gif|Files Preferences Dialog Pane]]</p>
-=====Allow rendering of ".pov" files only=====
+=====Allow rendering of .pov files only=====
 <p>With this option is useful when you frequently edit include and other
 files and do not want to <em>render</em> those files by accident.</p>
 =====Application creator codes for output files=====
 <p>You may select a specific application that will be made the default

@@ Line 61: / Line 61: @@
 regardless of the application memory size you set for the POV-Ray
 application.</p>
-<p class="explain">On Mac OS X applications may always use all available
+<p class="Explain">On Mac OS X applications may always use all available
 memory and as such, this option is disabled when running on Mac OS
 X!</p>
@@ Line 113: / Line 113: @@
 background color is white, you should not set any text elements to
 white.</p>
-<p class="note">Note: Symbol coloring is only updated when you save the
+<p class="Note">Note: Symbol coloring is only updated when you save the
 scene file to disc because it would be too slow updating while
 typing.</p>

← Older revision	Revision as of 18:24, 10 March 2009
(No difference)

← Older revision	Revision as of 18:22, 10 March 2009
(No difference)

Documentation:Mac OS Section 5 - Revision history

Jholsenback: image format changes

Jholsenback: heading title correction

Jholsenback: removed quotes from the heading title

Jholsenback: cleanup

Jholsenback: heading changes

Jholsenback: corrected case sensitive class id

Jholsenback: Protected "Documentation:Mac OS Section 5" [edit=sysop:move=sysop]

Jholsenback: 1 revision(s)

WikiSysop: /* Actions Pane */