This doc is protected, so submissions, corrections and discussions must be held on this paperwork discuss web page.

Getting Began

This part will assist new customers get began with POV-Ray for Home windows.

The Demo

You probably have by no means seen POV-Ray at work earlier than, begin by operating the demo (choose Render/Run
Demo), then click on on Begin Rendering. You will note POV-Ray for Home windows begin up a Render
Window and generate a pattern scene block by block. By default, these blocks are 32×32 pixels in dimension.
Discover that when you shut the Render Window, the rendering job shouldn’t be interrupted. You probably have POV-Ray
set as much as save the picture as a file (that is the default setting), that file will probably be produced whether or not
or not you show the picture on display as you render. To cease rendering, choose Render/Cease Rendering
(or use the keyboard short-cut ALT-G).

Even when you reduce the rendering window, POV-Ray for Home windows will show the progress of
the rendering job by displaying the share accomplished. When you shut the render window and need
it again, click on the appropriate mouse button over the principle POV-Ray window, and choose the suitable
menu merchandise, or simply click on the toolbar button labelled ‘Present’.

Beginning a Render Job

Beginning POV-Ray rendering any scene file is so simple as deciding on the file by way of the menu
(Render/Choose File and Render) or dragging and dropping it from Home windows Explorer. This may
work with both a POV file or an INI file (so long as it has an related POV file). See
Understanding File Varieties. The scene is rendered
with the present POV-Ray 3 choices (see Command-Line Choices).
Observe you can inform POV-Ray for Home windows to open a file within the editor as a substitute of rendering
it when you drag and drop it into this system (that is in reality the default setting now). See the
Choices Menu for extra data.

N.B. One of the vital frequent errors new customers make is popping off the show choice. The
Show choice (+d) is ON by default. When you flip this OFF within the INI file or on the command
line, POV-Ray won’t show the file as you render, regardless of what number of instances you press the
Present Render Window button. Nonetheless this doesn’t imply the rendered file shouldn’t be written to disk.

Please additionally be aware that POV-Ray for Home windows will write the output file to a .PNG by default.
There is no such thing as a option to ‘save the render window’ after rendering is accomplished. When you turned file
output off earlier than beginning the render, and alter your thoughts, you’ll have to begin the
rendering over again. We advocate that you just simply go away file output on on a regular basis.

Dragging and Dropping Recordsdata

Dragging and dropping (a.ok.a. Drag’N’Drop) from Home windows Explorer (a.ok.a. ‘My Laptop’) has the benefit that you just
can choose multiple file at a time. You’ll be able to drag and drop as much as 512 POV and/or INI information.
POV-Ray for Home windows will begin processing the primary file within the queue and add the remaining to the
queue. See File Queue dialog within the Render Menu for extra particulars.

Observe: If the dropped information vacation spot is about to Editor (the default), the information will
be opened within the inner editor as a substitute. In that case, there’s a restrict of 32 information that could be opened at anyone time.

File Associations

When POVWIN is put in utilizing the official installer, a file affiliation is established between .POV information and POVWIN.
Which means when you double-click on a file with the .POV extension it will likely be opened in POVWIN’s editor. As well as,
right-clicking on a .POV file to open the usual Home windows context menu will present two devoted menu entries: ‘Open’
and ‘Render with POV-Ray’. ‘Open’ is identical as double-clicking (internally it calls POVWIN with the ‘/EDIT’ choice).
Selecting ‘Render with POV-Ray’ will trigger the chosen file to be rendered by POVWIN (be aware that it isn’t opened within the
editor – having a file open within the editor shouldn’t be a requirement for rendering it).

Newer variations of Home windows permit customers to affiliate different file sorts with packages of their alternative; e.g. as a ‘default program’.
As a basic rule, if that is performed for POVWIN and the file is double-clicked, POVWIN will open it within the editor somewhat than render it (which
would in any other case be the default, for compatibility with variations of POV-Ray for different platforms). If you wish to affiliate a file
extension with POVWIN so as to render it somewhat than edit it, you will want to alter the affiliation to go the /RENDER command-line choice Documenting methods to change home windows to incorporate that is past the scope of this tutorial.


There’s a complete newbie’s tutorial included in
this assist file. It pertains to using POV-Ray typically (i.e. on all platforms, not solely
Home windows), so we advocate that you just learn the remainder of part 1 first earlier than trying to go
any additional, as part 1 tells you methods to use the interface of POV-Ray for Home windows itself.
The extra formidable could like to take a look at the superior tutorial

Understanding File Varieties

This part factors out the varied kinds of textual content information that POV-Ray for Home windows works with.

POV Recordsdata

POV-Ray for Home windows works with two kinds of plain textual content information. The primary is the usual
POV-Ray scene description file (often known as ‘SDL’, for Scene Description Language).
Though you might give information of this sort any official extension, it’s extra handy
for you when you identify them utilizing the .POV extension. On this Assist file, scene description
information are known as POV information.

The second sort, the initialization file, usually have .INI extensions and are referred to on this assist file as INI information.

INI Recordsdata

An INI file is a textual content file containing settings that instruct POV-Ray methods to render a scene.
These settings are totally different from what’s within the POV file, which accommodates directions to
POV-Ray about what’s in a scene.

You’ll be able to retailer a default set of choices within the file referred to as POVRAY.INI within the INI folder underneath
the POV-Ray paperwork folder. Except you selected to put in the user-specific information elsewhere
once you put in, this will probably be (for instance) ‘POV-RayvX.yinipovray.ini’ inside your
‘My Paperwork’ folder. There’s a command within the Instruments menu that lets you open this
immediately (no matter the place you put in).

You can even go some other INI file to POV-Ray for Home windows by deciding on it (by way of
Render/Choose File and Render) or by dragging it from the Home windows File Supervisor and
dropping it onto the POV-Ray window.

One of many choices you’ll be able to set in any INI file is the identify of an enter file. When you now
instruct POVRAY to render the INI file, it can use the above choice to find out what
POV file to learn to generate the precise picture. Some other choices offered within the INI file
can even be utilized to the picture; therefore this manner you’ll be able to customise POV-Ray settings for
any particular person scene file with out having to sort them in every time.

For example, if in case you have a file referred to as SCENE.POV, you’ll be able to create a file SCENE.INI to include
settings particular for SCENE.POV. When you embrace the choice ‘Input_File_Name=scene.pov’ in
SCENE.INI, after which ask POV-Ray to render SCENE.INI, POV-Ray will course of SCENE.POV with the
choices laid out in SCENE.INI.

Bear in mind, although, that any choices set on the POV-Ray for Home windows command line once you
course of an INI file override any corresponding choices within the INI file (see
Command-line Choices and
Render Menu).
Additionally, any choices you don’t set within the INI file will probably be inherited from any previously-processed INI information (e.g. POVRAY.INI).

You’ll be able to instruct POV-Ray to generate an INI file containing all of the choices lively on the time
of rendering. This manner, you’ll be able to go a POV file and its related INI file on to a different
particular person and be assured that they may be capable of generate the scene precisely the identical method you
did. See the part titled Utilizing INI Recordsdata for extra details about INI information.

INI File Sections

Sections aren’t information in themselves; they’re parts of INI information. Sections are a way of
grouping a number of units of POV-Ray choices collectively in a single INI file, by introducing them
with a bit label. Think about the next INI file, taken from the POV-Ray 3 documentation:

; This pattern INI file is used to set decision.

+W120 +H100 ; This part has no label.
; Choose it with "RES"

+W80 +H60 ; This part has a label.
; Choose it with "RES[Low]"

+W320 +H200 ; This part has a label.
; Choose it with "RES[Med]"

+W640 +H480 ; Labels aren't case delicate.
; "RES[high]" works

[Really High]
+W800 +H600 ; Labels could include blanks

If you choose this INI file, the default decision setting will probably be 120 x 100.
As quickly as you choose the [High] part, nevertheless, the decision turns into 640 x 480. See Edit Settings/Render
within the Render Menu for directions on deciding on sections. The ‘fast decision’ listbox in POVWIN is an instance of one of these file. For extra data on POV-Ray choices and INI information seek the advice of the part on
POV-Ray Choices.

Utilizing the Inside Editor

The POV-Ray inner editor is a sophisticated programmer’s editor, providing syntax highlighting for POV information (in addition to C, Java, and numerous different languages), a number of indent types, block indent/undent, column alternatives, OLE drag and drop, amongst different issues. Many of the key mappings are configurable, as are the colours and numerous different choices.

It consists of two elements – a customized management, and the ‘wrapper’ code that encapsulates it. It is vital that you just keep in mind this, as it can clarify a number of the conduct that it displays (for instance, not with the ability to reassign all keystrokes, simply most of them). It isn’t important for POVWIN’s operation to have the editor current – it’s fairly attainable for it to run with out it. Nonetheless, underneath regular circumstances, the editor is current.

See also  10 Unethical Psychological Experiments that Ended in Very Disturbing Results

As of model 3.7 there been a couple of notable adjustments to the POVWIN IDE.

  1. There may be now a Window menu, which is positioned the place the GUIEXT menu was once (the latter has moved to inside the Choices menu). The MRU (most-recently-used) association of this window menu makes it trivial to toggle between information with out taking your eyes off the textual content or utilizing the mouse. Essentially the most not too long ago view window (i.e. the present one) will at all times be entry 1 within the record. The second most not too long ago seen (i.e. the final window seen earlier than switching to the present one) will at all times be entry 2 within the record, and so forth. On condition that entries 1 by way of 10 within the record are given the menu mnemonics 1 by way of 0 respectively, all you want to do to toggle between the present and former information is hit Alt-W then 2. To go to the third oldest, Alt-W then 3, and so forth. Observe that the MRU record shouldn’t be saved on exit.
  2. An ‘alternate render file’ function was added. That is meant to make issues simpler when enhancing macro or embrace information. Whereas it’s attainable to make use of SDL to detect whether or not a macro/embrace file is being rendered immediately and to tug in supporting code, that strategy shouldn’t be very versatile. The alternate render file function permits a render to be began on an embrace file, and as a substitute of the embrace file being rendered immediately (as would have occurred beforehand), the supply file that the majority not too long ago included that file in a render will probably be rendered as a substitute. For this function to work, you want to have rendered a file which incorporates the goal file through the present enhancing session (the affiliation between embrace information and supply information shouldn’t be persevered when POVWIN exits). Moreover you want to have requested to render a supply file which doesn’t have the .POV or .INI extension. While you request the render, a message field will seem asking you what to do. You’ll be able to select to render the alternate file this time solely, to render the alternate file every time you render this one, or to render this one every time (i.e. disable the alternate file choice). In all circumstances, the selection you give solely persists for the present enhancing session; it isn’t restored once you re-launch POVWIN. that is by design.

    Observe: The time period ‘supply file’ means both a .POV, .INI, .MAC or .MCR file.

  3. It’s now attainable for customers to supply their very own customized key phrases for the SDL key phrase completion record and syntax highlighting.
    These key phrases are learn from the file ‘iniuser-keywords.txt’ (positioned within the POVWIN paperwork folder) when POVWIN begins up.
    A software menu entry gives a shortcut to open this for you.

The Editor Function Set

Listed below are only a few of the options provided by the editor, as applied in POVWIN:

Shade Syntax Highlighting.
Language-specific key phrases, feedback, and strings are coloured in a different way to set them other than plain textual content.

Key phrase Completion.
Language-specific key phrases will be mechanically expanded or cycled by way of by urgent the TAB key whereas the caret is on the finish of a partial key phrase. Customers can add their very own key phrases by enhancing a customized definition file.

A pop-up record of key phrases will seem when you press Ctrl + House anyplace within the editor window. If the edit caret is over a partial key phrase, the record will probably be scrolled appropriately.

Consumer Alternative Relating to Finish-Of-Line Habits.
Some customers choose the flexibility to put the edit caret past the top of line, whereas different customers dislike this conduct. You’ll be able to select both.

Customizable Keyboard Mappings.
Keystrokes will be added and eliminated to emulate common keyboard mappings. Over 120 particular person instructions are capable of be assigned to the keyboard.

Keystroke Macros.
Customers can report a sequence of keystrokes and assign a keystroke to play again the keystrokes repeatedly. As much as 10 macros could also be recorded. These are preserved throughout enhancing periods.

Drag and Drop Textual content Manipulation.
Highlighted textual content will be dragged and dropped between any window supporting OLE textual content Drag and Drop. Textual content could also be copied or moved.

Column Choice and Manipulation.
Columns of textual content will be chosen with the mouse after which manipulated. Empty columns (columns with a width of zero characters) will be chosen, inflicting subsequent typing and deletion to happen over a number of traces on the identical time.

A number of Break up Views.
Customers can create as much as 4 separate views of the identical edit buffer. Every view will be scrolled independently.

Limitless Undo/Redo.
All edit actions are totally undoable and redoable. A restrict will be set on the variety of edit actions that could be undone.

Auto Indentation.
As soon as a language is chosen, because the person enters code, CodeMax will mechanically indent traces to following the scoping guidelines of the language.

Elective Auto-Save.
If turned on, modified information are saved periodically.

Elective Auto-Reload of Modified Recordsdata.
The editor will optionally mechanically reload an editor file that was modified by an exterior program whereas POVWIN did not have the main target. It will possibly additionally immediate you as as to whether or not you need it reloaded (which is the default conduct).

Brace Matching
Urgent the Ctrl + ] key whereas the edit caret is on a ’[’, ’(’ or ’{’ will cause the caret to jump to the matching ’]’, ’)’ or ’}’, and vice-versa.

Block Indent/Undent
Urgent the TAB or Shift + Tab keys will indent or unindent a particular block of textual content.

You’ll be able to convert textual content that was formatted with laborious TAB characters into space-expanded kind, and vice-versa.

Customizable Colours.
All editor colours (together with the background) are customizable. POVWIN additionally gives two ’fast set’ defaults – white textual content on a black background and black textual content on a white background.

Good Case Preservation in Change Operations.
Throughout search and exchange, you’ll be able to optionally have the changed textual content retain its unique case.

Enhanced MRU (Most Not too long ago Used information) Checklist
POVWIN’s MRU record not solely remembers the filenames of not too long ago opened information, it additionally remembers the the road, column, and language settings.

Key phrase Growth and CodeList
This function permits quick insertion of ordinary POV-Ray key phrases both by typing a partial match and hitting TAB, or through the use of Ctrl + House to carry up a whole record.

Editor Tab Proper-Click on Menu
Along with the same old ’Copy filename to clipboard’ and ’Open containing folder’, there are additionally menu entries to save lots of the file, shut it, shut all but it surely, transfer the tab left and transfer the tab proper. As well as these new entries have additionally been added to the window menu. There is no such thing as a default key mixture for transferring tabs left or proper as the obvious bindings are already in use. Customers can assign no matter they wish to it within the editor preferences dialog.

Turning the Inside Editor On or Off

Choose the Choices|Different Settings|Use Editor menu merchandise. If that is off, POV-Ray for Home windows
won’t try and load the editor DLL at startup, and the editors won’t be accessible.

Stopping File Restore

By default, POV-Ray for Home windows will try and re-load the information you had open within the editor
once you final exited this system. If this causes an issue (e.g. possibly one of many information is
very massive and you do not need it re-loaded), you’ll be able to add the ‘/NR’ (or ‘/NORESTORE’) choice
to the POV-Ray for Home windows command line. On this case POVWIN will flush the record of information you
had opened.

Switching between Editor home windows

You should utilize the Alt+LeftArrow and Alt+RightArrow keys to cycle amongst the editor home windows and
the message window. Some customers are extra comfy with Ctrl-Tab, so that is accessible as nicely.

Key phrase Growth and CodeList

This facility is designed to hurry up the authoring of POV-Ray scene information by permitting you to
shortly insert any of the usual or user-defined key phrases by typing a part of the phrase and urgent TAB (offered
you may have the ‘Overlay Key phrase Growth On Tab Key’ choice within the Editor Menu
turned on).

If this feature is enabled, the tab key serves two features: it firstly will operate to invoke
key phrase enlargement, and secondly, if it seems that key phrase enlargement shouldn’t be desired on the
present edit place, it features as a standard tab key (inserting tabs or areas as outlined
by your configuration of the editor).

A Fast Instance

Earlier than entering into the reason beneath, we advise you strive it for your self. Firstly, make
certain that ‘Overlay Key phrase Growth On Tab Key’ is turned on (that is the default so except
you may have turned it off it can already be on).

Now, open a .POV file in an editor when you do not have already got one open, and place the edit cursor (‘caret’)
on a clean line and kind the letters ‘am‘, then press TAB. The phrase ‘ambient
ought to now seem the place you had ‘am‘. Now press it once more and you will notice the phrase
ambient‘ turn into ‘ambient_light‘. Now press SHIFT+TAB (shift and tab
collectively) and you will notice that it goes again to ‘ambient‘, and, if pressed once more, again
to plain ‘am‘.

How Key phrase Growth Works

While you press TAB, the editor firstly seems to be on the characters to the left and proper of the present
edit caret place. If there may be clean house to the left of the caret, or there is no such thing as a
clean house to the appropriate of the caret then key phrase enlargement doesn’t happen and the TAB
key will operate usually. Observe that for the needs of this take a look at, the beginning of the road is
not thought-about clean house, however the finish of the road is.

To go the above take a look at, subsequently, the caret should be on the finish of a phrase containing not less than
one character, adopted by an area, tab, or the top of the road. The editor will then get this
phrase from the road and evaluate it (with case-sensitivity) in opposition to the record of identified POV-Ray
scene file key phrases that it holds internally.

See also  thorium vs calamity 2020

If the above comparability yields an ideal match (that’s, the phrase on the left of the caret is
precisely the identical as a key phrase), then key phrase enlargement doesn’t happen and the tab key features

If the above take a look at fails (that’s, the phrase shouldn’t be an ideal match), then a take a look at is made
for a partial match. If the phrase on the left of the caret doesn’t even partially match
any phrase within the key phrase record, then enlargement doesn’t happen and the tab key features

If the above take a look at passes, the phrase on the left of the caret should be a partial
key phrase (for instance, ‘pigm‘ is taken into account a partial key phrase for the reason that
editor is aware of that ‘pigment‘ is a key phrase). Given this truth, the editor
extracts the record of all key phrases that match the partial key phrase (within the above instance,
pigment‘, ‘pigment_map‘, and ‘pigment_pattern
all include the prefix ‘pigm‘ and as such can be included within the record).

The editor shops this record in reminiscence after which completes the partial key phrase with the
first one (alphabetically) from the record it saved (within the above instance, this might be
pigment‘). As soon as this has occurred, the editor is in ‘key phrase enlargement’
mode. The editor stays on this mode till you progress the edit place or in any other case make
any change to the textual content aside from by way of TAB and SHIFT-TAB enlargement.

Urgent TAB once more will trigger the following key phrase within the saved record of attainable matches to
seem, changing the primary one, and so forth. When you attain the top of the record, urgent
TAB will trigger the caption bar of POV-Ray for Home windows to flash. This can be a visible indication
that there are not any extra key phrases within the ahead path.

Urgent SHIFT+TAB causes the earlier key phrase to seem, and if you’re on the
first key phrase within the record, it can trigger the unique textual content you typed to be restored. If
you’re on the unique phrase and press SHIFT+TAB, the caption bar will flash to point
that you just can’t return any additional.

Whereas all this sounds complicated in idea, it’s in follow very easy and pure
to make use of, and when you get used to it you most likely will not wish to return to the previous method of
doing issues.

The benefit of key phrase enlargement turns into clear when you have a look at the next instance:
suppose you wished to enter the ‘smooth_color_triangle‘ key phrase. You could possibly
after all sort the whole key phrase in (a complete of twenty-one keystrokes). Or, utilizing
key phrase enlargement, you would enter it utilizing solely 4 keystrokes by typing
sm‘ then TAB and TAB once more. The primary tab expands it to ‘clean
and the second tab expands all of it the way in which to ‘smooth_color_triangle‘.

Trace: When you use key phrase enlargement and by chance develop to a phrase you do not need, if
you have not but exited key phrase enlargement mode, one of the simplest ways to get again is to make use of SHIFT+TAB
to go backwards. It is extremely simple to simply hit the traditional ‘Undo’ key out of behavior. Whereas this
will work, it will not at all times restore the caret place. Utilizing SHIFT+TAB additionally strikes the edit
caret again to its beginning place in addition to restoring the beginning phrase.


The CodeList function is, like Key phrase Growth, designed to make enhancing POV-Ray scene information extra handy. It’s by default assigned to the keystroke CTRL+SPACE (you’ll be able to change this from the Keyboard Configuration property web page).

Not like key phrase enlargement (which lets you cycle by way of an inventory of key phrases, one by one), CodeList lets you see a lot of them directly, and choose one with the cursor keys or mouse.

Utilizing CodeList

While you press CTRL+SPACE, the editor will extract the phrase underneath or instantly to the
left of the edit caret (be aware that this differs from key phrase enlargement, which requires
that the caret be on the finish of a phrase). If this phrase is clean (that’s, the caret was on
clean house), or if the phrase doesn’t even partially match any key phrase, an alphabetically-sorted
record of all POV-Ray scene file key phrases is displayed barely to the appropriate of and
beneath the edit place. If the extracted phrase was clean, the record will probably be positioned at
the primary entry, in any other case it will likely be positioned on the key phrase that’s closest
(alphabetically) to the extracted phrase.

If, nevertheless, the extracted phrase completely matches a key phrase, and isn’t a part of
some other key phrase within the record, then the record field doesn’t seem. As a substitute, the key phrase
that it matched is inserted into the road and the edit caret is moved to the top of that
key phrase.

If the above match doesn’t happen, then the alphabetically-sorted record of key phrases is
displayed, and the record is positioned such that the key phrase that the extracted phrase most
intently matches is highlighted and is as shut as attainable to the middle of the displayed
portion of the record.

When you have a look at the above picture, you will notice an instance of this case. The partial
key phrase (simply above and to the left of the highest left-hand nook of the record field) is
phon‘, and the record has been positioned to the closest key phrase, which is

As soon as the record is displayed, you’ll be able to trigger the highlighted entry to be inserted into the
line by simply urgent ENTER, SPACE, TAB, or CTRL+SPACE once more, or by double-clicking on a
record entry. Urgent the ESCAPE key will take away the listbox with out altering the road you
are enhancing. You’ll be able to navigate the listbox through the use of the up, down, page-up and page-down keys
in your keyboard, by the mouse, or by typing (see beneath). When you trigger textual content to be inserted
by any of the above strategies aside from SPACE, the edit caret will probably be positioned instantly
on the finish of the inserted phrase. If, nevertheless, you press SPACE, the phrase will probably be inserted
adopted by an area, and the brand new edit place will probably be after the house.

Whereas the record is displayed, although the up and down arrow keys map to the listbox,
the traditional character keys nonetheless map to the editor. When you proceed to sort, the letters
will probably be typed into the road on the editor caret place, and, moreover, the record
field will mechanically scroll in order that the highlighted line is at all times the key phrase that
has the closest match to what you may have typed in.


Identical to key phrase enlargement, the codelist function can appear difficult when defined
in phrases. Nonetheless, when you get used to it, it can turn into fairly pure to make use of.

Configuring the Inside Editor

The built-in editor is extensively customizable. It makes use of syntax highlighting and understands .POV, .INC, .MAC, and .MCR information as being in POV syntax. You’ll be able to change the colour settings used from the properties dialog (Alt + Enter). It additionally has built-in syntax highlighting for C, C++, Java, Fundamental, Pascal, SQL, HTML and XML. Customers may also add their very own key phrases for syntax highlighting and auto-completion within the editor. See the file iniuser-keywords.txt positioned within the person’s POV-Ray paperwork folder (or use the software menu shortcut to open it).

Essential Editor Notes

One vital factor to notice instantly is that the editor properties dialog
solely lets you set issues which can be applied inside the editor (keep in mind, the editor is
two elements – a DLL referred to as ‘povcmax32.dll’ (or comparable), and one other DLL which masses
and ‘wraps’ it into POV-Ray for Home windows). There are another choices applied inside the
editor wrapper code in POV-Ray for Home windows that are capable of be accessed by way of the Editor menu
(solely seen when an editor is chosen). For instance, the keybinding for saving a file
(Ctrl-S) shouldn’t be listed within the editor properties since this operate is dealt with by the wrapper
code. You’ll be able to’t change this project.

Some folks have requested why the do not ask once more choice within the render save dialog shouldn’t be
persistent throughout periods. That is by design and isn’t more likely to change.

The edit window context menu has an choice for ‘present/cover message window’. This window – when
displayed on the backside of an editor window – is sizable. A fast option to shut the message
window is simply to hit ESCAPE, or drag the divider all the way down to inside a couple of pixels of the underside
border – once you launch the mouse, the message window will vanish.

You can even inform POVWIN to not show the message window mechanically when beginning a
render. You do that from the Editor menu, by turning off ‘Auto-Present Parse Messages’. That is
most helpful with the Error File choice.

POVWIN will optionally mechanically load a file through which a parse error has occurred into the
editor (or choose it if it is already loaded) and place the cursor on the road and column of
the offending code. This is ready to be turned on or off utilizing the ‘Auto-Load Error File’
choice within the Editor menu. Additionally, if this feature is on, and the message window was displayed
mechanically (see above), it will likely be closed mechanically somewhat than being left open. The
textual content describing the error will probably be displayed within the standing bar on the backside of the window.
Observe that, often, if the error happens inside a macro, the displayed line/column for
the error will probably be improper (although that is unusual).

See also  Rotate Video [Windows Media Player, VLC, etc. Included]

Default Key Mappings

Listed beneath is the entire set of default keystrokes and the CodeMax command that every
keystroke maps to. Observe that many rely upon caret place. If two units of keystrokes
are listed, both could also be used (e.g. ‘Copy’ is outlined as ‘Ctrl + C or Ctrl + Insert’, which
means that you could be use both ‘Ctrl + C’ or ‘Ctrl + Insert’ to carry out a duplicate; whichever
fits you. There is no such thing as a distinction between one or the opposite).

Observe that if multiple key sequence is assigned to a command, and the command is one in all
these listed within the menus (not all instructions are listed within the menus), the important thing sequence proven
because the shortcut key within the menu is mostly the shortest one (when it comes to its printed

You’ll be able to change any of the below-mentioned key assignments if the defaults do not go well with you.
Moreover, the beneath desk doesn’t record the greater than 50 instructions for which there is no such thing as a
default key project. Use Alt + Enter on an editor display, or choose
‘Codemax Properties’ from the Editor menu to assign these.

BookmarkNext F2 Transfer to subsequent bookmark

BookmarkPrev Shift + F2 Transfer to earlier bookmark

BookmarkToggle Ctrl + F2 Place a bookmark

CharLeft Left Arrow Transfer caret left

CharLeftExtend Shift + Left Arrow Transfer caret left and spotlight

CharRight Proper Arrow Transfer caret proper

CharRightExtend Shift + Proper Arrow Transfer caret proper and spotlight

CodeList Ctrl + House Present key phrases (reference or insertion into file)

Copy Ctrl + C or Ctrl + Insert Copy choice to clipboard

Lower Ctrl + X or Shift + Delete Take away choice to clipboard

CutSelection Ctrl + Alt + W Take away choice (identical as Lower)

Delete Delete Delete one character proper (can Undo)

DeleteBack Backspace or Shift + Backspace Take away one character left (can Undo)

DocumentEnd Ctrl + Finish Transfer to finish of file

DocumentEndExtend Ctrl + Shift + Finish Transfer to finish of file and spotlight

DocumentStart Ctrl + Residence Transfer to begin of file

DocumentStartExtend Ctrl + Shift + Residence Transfer to begin of file and spotlight

Discover Alt + F3 or Ctrl + F Discover, or search

FindNext F3 Discover subsequent (specified)

FindNextWord Ctrl + F3 Discover subsequent (chosen)

FindPrev Shift + F3 Discover earlier (specified)

FindPrevWord Ctrl + Shift + F3 Discover earlier (chosen)

FindReplace Ctrl + Alt + F3 or Ctrl + H Discover/Change dialog

GoToLine Ctrl + G Transfer to a line quantity dialog

GoToMatchBrace Ctrl + ] Match brace }, bracket ], or parenthesis )

Residence Residence Transfer to begin of line textual content (or line)

HomeExtend Shift + Residence Transfer to begin of line and spotlight

IndentSelection Tab Indentation (variety of areas set in properties)

LineCut Ctrl + Y Take away present line

LineDown Down Arrow Transfer to subsequent line

LineDownExtend Shift + Down Arrow Transfer to subsequent line and spotlight

LineEnd Finish Transfer to finish of line textual content (or line)

LineEndExtend Shift + Finish Transfer to finish of line and spotlight

LineOpenAbove Ctrl + Shift + N Make new line above present line

LineUp Up Arrow Transfer to earlier line

LineUpExtend Shift + Up Arrow Transfer to earlier line and spotlight

LowerCaseSelection Ctrl + U Change highlighted textual content to decrease case

PageDown Web page Dn Transfer down a web page

PageDownExtend Shift + Web page Dn Transfer down a web page and spotlight

PageUp Web page Up Transfer up a web page

PageUpExtend Shift + Web page Up Transfer up a web page and spotlight

Paste Ctrl + V or Shift + Insert Place clipboard contents into file

Properties Alt + Enter CodeMax properties dialog

RecordMacro Ctrl + Shift + R Report/cease a macro

Redo Ctrl + Y Redoes final undone motion (i.e. undo an undo)

SelectAll Ctrl + A Spotlight whole file

SelectLine Ctrl + Alt + F8 Spotlight the present line

SelectSwapAnchor Ctrl + Shift + X Swap place of caret with begin of highlighting

SentenceCut Ctrl + Alt + Okay Take away a steady line to clipboard

SentenceLeft Ctrl + Alt + Left Arrow Transfer to begin of steady line

SentenceRight Ctrl + Alt + Proper Arrow Transfer to finish of steady line

SetRepeatCount Ctrl + R Variety of instances to do subsequent command

TabifySelection Ctrl + Shift + T Change highlighted areas to tabs

ToggleOvertype Insert Toggle between inserting and overwriting

ToggleWhitespaceDisplay Ctrl + Alt + T Present or cover areas

Undo Ctrl + Z or Alt + Backspace Undo final change

UnindentSelection Shift + Tab Take away indentation of chosen line

UntabifySelection Ctrl + Shift + House Change highlighted tabs to areas

UpperCaseSelection Ctrl + Shift + U Change highlighted textual content to higher case

WindowScrollDown Ctrl + Up Arrow Scroll file down, leaving caret

WindowScrollLeft Ctrl + Web page Up Scroll file left, leaving caret

WindowScrollRight Ctrl + Web page Dn Scroll file proper, leaving caret

WindowScrollUp Ctrl + Down Arrow Scroll file up, leaving caret

WordDeleteToEnd Ctrl + Delete Delete a phrase from caret to finish

WordDeleteToStart Ctrl + Backspace Delete a phrase from caret to begin

WordLeft Ctrl + Left Arrow Transfer to begin of present phrase

WordLeftExtend Ctrl + Shift + Left Arrow Transfer to begin of present phrase and spotlight

WordRight Ctrl + Proper Arrow Transfer to finish of present phrase

WordRightExtend Ctrl + Shift + Proper Arrow Transfer to finish of present phrase and spotlight

Setting Key Mappings

Many of the keystrokes utilized by the editor are re-assignable – even these listed within the menus.
(Some customers have assumed that instructions with shortcuts listed within the menus aren’t assignable,
however this is not the case – when you change the project, the brand new shortcut reveals up within the

Every editor command can have as much as two totally different keyboard actions assigned to it, and every
keyboard motion could have both one or two keystrokes. Most customers will use just one keystroke,
however those that are nonetheless acquainted and cozy with the previous ‘Wordstar’ key assignments (e.g.
Ctrl-Q, F for Discover) will probably be happy to find that these are nonetheless accessible to them, ought to
they wish to take the time to assign them.

When you assign multiple key sequence to a command, and the command is a type of listed
within the menus (not all instructions are listed within the menus), the one that’s listed within the menu as
the shortcut secret’s typically the shortest one (when it comes to its printed illustration).

You’ll be able to entry the keystroke assignments by way of the CodeMax properties dialog.
By default, that is mapped to Alt+Enter when an editor is displayed. Alternatively, you will get
at it from the Editor menu (solely seen when an editor is chosen) or the editor right-mouse-button
context menu.

Reserved Keys

Not all instructions are assignable ! Generally, solely the instructions which can be immediately
applied within the CodeMax editor DLL are capable of be set. These instructions are ones that relate to
operations on particular person edit buffers. They don’t embrace things like file operations
(load, save, print, and many others). These operations are applied within the POVWIN editor wrapper code
and aren’t managed or capable of be modified by CodeMax. Due to this fact, it must be clear that you just
can neither change the important thing bindings for operations similar to file save, nor use the POVWIN-
assigned keystroke (e.g. Ctrl-S within the case of save) for some other goal.

Utilizing the Mouse

The editor helps the next mouse actions:

Left click on over textual content Adjustments the caret place

Proper click on over open file Shows the pop-up menu

Left Button down over choice, maintain and drag Strikes textual content

Ctrl + Left Button down over choice, maintain and drag Copies textual content

Left click on over left margin Selects line

Left click on over left margin, maintain and drag up or down Selects a number of traces

Alt + Left Button down, maintain and drag Choose columns of textual content

Left double click on over textual content Choose phrase underneath cursor

Spin IntelliMouse (suitable) mouse wheel Scroll the window vertically

Single click on mouse wheel Choose the phrase underneath the cursor

Double click on mouse wheel Choose the road underneath the cursor

Click on and drag splitter bar Break up the window into a number of views
or alter the present splitter place

Double click on splitter bar Break up the window in half into a number of views
or unsplit the window if already cut up

Hints for Match Brace

A number of European customers have commented that the default key project for ‘Match Brace’
(Ctrl-]) shouldn’t be usable on their keyboards. Please be aware you can change this to no matter
you please. One other factor to recollect in regards to the match brace command is that it solely works whether it is
executed when the edit caret is on a brace character (‘{‘, ‘}’, ‘(‘, ‘)’, ‘[‘, ‘]’). The caret
will then soar to the matching character (e.g. if it is on a ‘(‘, it can soar to the matching ‘)’).

The Language Setting

The language setting is an efficient instance of a setting that applies to the present file solely.
This setting determines what kind of syntax highlighting is utilized to the file. For instance,
a POV or INC file would most likely have a language setting of ‘POV-Ray’. A Java file (do you have to
select to make use of POVWIN to edit one) would have a language setting of ‘Java’.

This setting is initially (once you first open a file, or create a brand new one) set based on
the file extension. .POV, .INC, .MCR and .MAC information are thought-about POV syntax. A brand new file (one with the
identify ‘Untitled’) has no language.

As soon as the file is first loaded, you’re free to alter the language to no matter you want.
This modification impacts solely the present file and no different file ! The change you may have made
will probably be remembered by POV-Ray. Any file that’s nonetheless within the MRU record (or the ‘Older File’
record – see the File Menu part for extra particulars) has its language setting saved together with numerous different file-specific attributes.

Observe that when you open a file manually (utilizing Drag-Drop or the file browse dialog, for instance),
the previous settings are discarded, even when the file was within the MRU record. That is by design.

The Font Setting

The Font setting is an efficient instance of a world setting – it impacts all open information. When you
change the font used within the editor, all open information get the brand new font, in addition to any new information
opened after that time.

This doc is protected, so submissions, corrections and discussions must be held on this paperwork discuss web page.

Leave a Reply

Your email address will not be published.