place_file_syntax
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
place_file_syntax [2025/03/17 14:00] – [MARK / DELETE MARK] jeffd | place_file_syntax [2025/03/18 00:47] (current) – [LOCATION DEFAULTS:] jeffd | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== Place File Synax ====== | ====== Place File Synax ====== | ||
+ | |||
+ | [[Place Files]] | ||
+ | |||
+ | ===== Overview ===== | ||
+ | |||
+ | Place files contain: | ||
+ | |||
+ | * A Header consisting of one or more Header Lines. | ||
+ | * Areas (or Libraries) which serve as namespaces containing: | ||
+ | * Locations (each has a mandatory prefix of either Int. or Ext.) | ||
+ | * Some Locations may be logically treated as Main Locations comprised of Sub-Locations. | ||
+ | * If a slash is present in a Location name, it separates the Main Location from the Sub-Location. | ||
+ | * Camera Angles (Named with A-Z,0-9,_) | ||
+ | * Package Definitions | ||
==== Header Line ==== | ==== Header Line ==== | ||
Line 11: | Line 25: | ||
==== Comments ==== | ==== Comments ==== | ||
+ | |||
+ | Comments may be included anywhere in the .place file: | ||
< | < | ||
; Any line beginning with a semicolon is a comment. | ; Any line beginning with a semicolon is a comment. | ||
</ | </ | ||
+ | |||
+ | ----- | ||
+ | |||
+ | ===== Importing Content from Other Files ===== | ||
==== IMPORT FROM / IMPORT ALL ... FROM ==== | ==== IMPORT FROM / IMPORT ALL ... FROM ==== | ||
Line 73: | Line 93: | ||
REFER TO IMPORTED " | REFER TO IMPORTED " | ||
</ | </ | ||
+ | |||
+ | ----- | ||
+ | |||
+ | ===== Packaging Sets of Locations ===== | ||
==== PACKAGE ==== | ==== PACKAGE ==== | ||
- | Packaging | + | Packaging |
< | < | ||
Line 92: | Line 116: | ||
UNPACK " | UNPACK " | ||
AS " | AS " | ||
+ | </ | ||
+ | |||
+ | ----- | ||
+ | |||
+ | ===== Location Definitions ====== | ||
+ | ==== LOCATION DEFAULTS: ==== | ||
+ | |||
+ | This opens up the template for locations defined within this Library or Area that aren't BASED ON any other location. Once this line is encountered, | ||
+ | |||
+ | < | ||
+ | LOCATION DEFAULTS: | ||
+ | |||
+ | A-CAM: | ||
</ | </ | ||
Line 118: | Line 155: | ||
INT. OFFICE | INT. OFFICE | ||
- | You look around to gain your bearings. | + | You look around to gain your bearings. $DESCRIPTION |
- | + | ||
</ | </ | ||
Line 143: | Line 178: | ||
</ | </ | ||
- | ==== @ (EXITS) | + | ==== x-CAM / DELETE x-CAM ==== |
- | Exits can be any of the abbreviated compass directions (N, NNE, NE, ENE, E, ESE, SE, SSE, S, SSW, SW, WSW, W, WNW, NW, NNW), UP, or DOWN. | + | This is how to assign cameras to a location. |
- | Locations | + | Note that the same Camera Angle can be assigned to multiple named CAMs, which may be useful (for example) if the coverage area is wider than what had originally been envisioned. |
+ | |||
+ | If a camera includes visibility of other locations, pass those location names in parenthesis as named parameters to the Camera Angle. | ||
+ | |||
+ | If the current Location is not the primary subject of the desired camera, you may use POV and the primary Location name to treat that Location as primary, and then list which of the Camera Angle' | ||
+ | |||
+ | Note also that each CAM designation may list more than one Camera Angle. | ||
+ | |||
+ | When a location | ||
< | < | ||
- | @ENTER DOOR: Int. | + | A-CAM: OFFICE |
+ | B-CAM: OFFICE_REVERSE(HALL = "Ext. Office" | ||
+ | C-CAM: POV "Ext. Office" | ||
</ | </ | ||
- | ==== SCOPE LIMITERS | + | To delete an existing CAM definition from this location: |
+ | |||
+ | < | ||
+ | DELETE C-CAM | ||
+ | DELETE OFFICE_REVERSE FROM B-CAM | ||
+ | </ | ||
+ | |||
+ | ==== @(EXIT) / DELETE @(EXIT) | ||
+ | |||
+ | Defines, edits, or deletes exits in the current location. | ||
+ | |||
+ | Exits can be a simple direction or a named target: | ||
+ | |||
+ | Simple directions include the abbreviated compass directions (N, NNE, NE, ENE, E, ESE, SE, SSE, S, SSW, SW, WSW, W, WNW, NW, NNW), UP, or DOWN. | ||
+ | |||
+ | Target names may not include spaces. | ||
+ | |||
+ | Locations may be substantially abbreviated. | ||
+ | |||
+ | After a location, flags may be given in parenthesis. | ||
+ | |||
+ | < | ||
+ | DELETE @N | ||
+ | @NW Ext. BACK ALLEY (WINDING) | ||
+ | @DOOR Int. (ONE WAY) | ||
+ | </ | ||
- | G$ = Ghostwood GL Engine \\ | ||
- | U$ = Fully 3D Rendering Engine \\ | ||
- | T$ = Text Adventure Engine \\ | ||
place_file_syntax.1742245223.txt.gz · Last modified: 2025/03/17 14:00 by jeffd