Difference between revisions of "SCP Additions"

From FreeSpace Wiki
Jump to: navigation, search
m
Line 1: Line 1:
<font color=yellow>'''WARNING: THIS PAGE IS BEING DESIGNED'''</font>
+
<font color=yellow>'''WARNING: THIS PAGE IS BEING DESIGNED'''
  
This section is just now being built and designed. Please wait a little before real posting inside it or its linked pages and subsections.
+
This section is just now being built and designed. Please wait a little before real posting inside it or its linked pages and subsections.  
  
==Introduction==
+
Now the main target is deciding how the page should look and which sections it should contain.
 +
 
 +
Please post your comments in this forum thread: [http://www.hard-light.net/forums/index.php/topic,44892.0.html]
 +
 
 +
At the beginning, I thought about two related lists: One sorted by Date and another by category. But I feel that posting and linking them can be quite tedious. So now I've rebuilt an alternative list just sorted by date but with Category looking.
 +
 
 +
Please take a look and post your suggestions.
 +
 
 +
 
 +
</font>
 +
 
 +
 
 +
 
 +
==1st possible structure. Two linked lists==
 +
 
 +
===Introduction===
  
 
The main thing the Source Code Project do is adding features to the retail game engine. BLA, BLA, BLA
 
The main thing the Source Code Project do is adding features to the retail game engine. BLA, BLA, BLA
Line 11: Line 26:
 
'''''[[SCP Additions: List by Category]]'''''
 
'''''[[SCP Additions: List by Category]]'''''
  
==Posting Rules==
+
===Posting Rules===
  
 
<font color=red>Please follow the rules. Even if you don't agree with some of them, follow them. This section can grow huge and it can become a damn hell. So we need one and only set of rules. And we all must follow it.
 
<font color=red>Please follow the rules. Even if you don't agree with some of them, follow them. This section can grow huge and it can become a damn hell. So we need one and only set of rules. And we all must follow it.
Line 74: Line 89:
 
##** ''Description:'' Whatever...<br>...
 
##** ''Description:'' Whatever...<br>...
 
##** ''Usage Tips:''
 
##** ''Usage Tips:''
 +
 +
 +
==2nd possible structure. Just sorted by date (but, more or less, with old category list looking)==
 +
===Introduction===
 +
 +
BLA, BLA, BLA
 +
 +
===Posting rules===
 +
 +
<font color=red>Please follow the rules. Even if you don't agree with some of them, follow them. This section can grow huge and it can become a damn hell. So we need one and only set of rules. And we all must follow it.
 +
 +
No discussion here, please.</font>
 +
 +
 +
# '''1st. GOLDEN RULE: Be extremely brief.'''
 +
#* Do not make long explanations within the lists.
 +
#* In each entry '''Description''' section write a brief explanation.
 +
#* If you need a deeper explanation for that feature put a link, (or links), in '''See''' section. Even create new pages if needed.
 +
# '''2nd. GOLDEN RULE: Be extremely tidy.'''
 +
#* As you can imagine, this Wiki section can become a mess quite easily.
 +
#* Always check that all the links work.
 +
# '''General posting rules.'''
 +
## As they should be quite intuitive, please follow any other example you find already posted.
 +
## This list is actually two lists:
 +
##* Features that belong only to HEAD experimental builds.
 +
##* Features that belong also to stable builds. This kind of features are also present in HEAD builds. These builds are the seed for ''official'' SCP releases (like 3.6.9).
 +
## Therefore, be sure you know if the feature must go to '''HEAD Branch''' or '''Stable Branch'''.
 +
## '''Be extremely tidy in the place and date you post'''. The list should be always kept sorted in descending date order (the most recent additions should go in the upper part of each section).
 +
## If the CVS date for your feature doesn't exist, create a new one.
 +
## Always '''use Japanese YYYY-MM-DD format'''. So January 27th in 2007 should be 2007-01-27. (In this way the ''number'' of the date always grows when a day advances).
 +
## Each new date should be a list item, ie. start it with *
 +
### Each new feature in a given date should be a sublist item, ie. start it with **
 +
### Each new feature has four sections. These subsections are sub-sublist items, ie. start them with ***:
 +
###*'''Description:''' A brief description of the feature.
 +
###*'''Category:''' The game category this feature falls in. It can be useful for people that want to look for just new "Sound" features for example. '''Please check the spelling and do not invent new categories'''. If you type "suond" or if we have one thousand different categories, this field is useless. <br>You can assign several categories if you feel the feature you are posting about can fall in several areas. <br>The ''official'' categories are:<br><font color=yellow>WARNING: We have to decide exact category names too ...</font>
 +
###**''Mission features''. All the new stuff you can add to missions through FRED, ie. new sexps, backgrounds, new mission options, ...
 +
###**''FRED interface''. Any other FRED improvements, like Voice Acting Manager, which don't fall in the previous one.
 +
###**''Graphics''. All the extra graphical capabilities added like OGL support, shine, glow, env or normal mapping...
 +
###**''Sound''. Just the same with sound and music (ogg support as example).
 +
###**''Game interface''. F3 Lab, showing models in loadout screen, showing ship info in hud, extended hud capabilities...
 +
###**''Models''. Everything that has to do with ship models like higher poly limits, glow points...
 +
###**''Tables and modding''. Everything that allows modders to customize FS2 and it's not directly set in FRED as a mission feature. Examples: Data management (-MOD flag), extended texture format support, modular tables, "un-hardcoded" tables like iff_defs, 3D shockwaves, 3D warp effects...
 +
###**''Scripting''. (I know nothing about it)
 +
###**''Multiplayer''. (I know nothing about it, again)
 +
###**''Coding''. Technical coder info which maybe is not directly seen in game but needs to be told. Like "I have changed all the arrays with pointers in this subroutine". (Sorry if I'm telling nonsenses but I'm no coder at all, I think you can imagine what I want to say).
 +
###*'''See:''' Put the links here to related pages with deeper info about that feature. If you want to post a lot of info about your feature, create your own page and put the link here.
 +
###* '''Usage Tips:''' In the future, creating a tips page somewhere in the Wiki is intended. In this section you could explain useful tricks. Put here the links to the tips this feature is useful for here.<br>''If you feel like it, you can even start that tricks page ;) . Some discussion can be found [http://www.hard-light.net/forums/index.php/topic,44892.0.html here].''
 +
## If your feature is ''upgraded'' from the HEAD to the stable branch, '''please move it to that section and update the dates
 +
## If you want you can use the next colour code to tell the addition importance:
 +
##* <font color=red>'''Critical update'''</font>. (This would be an extremely important update over retail behaviour).
 +
##** ''Description:'' Whatever...<br>...
 +
##** ''Usage Tips:''
 +
##* '''Common update'''. (Normal updates).
 +
##** ''Description:'' Whatever...<br>...
 +
##** ''Usage Tips:''
 +
##* <font color=green>'''Just a tweak'''</font>. (This would be just a tweak over retail Freespace2).
 +
##** ''Description:'' Whatever...<br>...
 +
##** ''Usage Tips:''
 +
##When a new official release appears, '''Stable > CVS''' subsection name is just changed to the new build denomination and a new '''Stable > CVS''' section is created.
 +
 +
 +
 +
 +
 +
===Feature list sorted by date===
 +
====HEAD Branch (CVS) - Experimental, non-canon features====
 +
 +
====Stable Branch====
 +
 +
=====CVS=====
 +
 +
 +
=====3.6.9. build=====
 +
*'''YYYY-MM-DD'''. Unknown date:
 +
**'''Environmental mapping'''
 +
***'''Description:''' Ship hulls reflect background bitmaps. Additionally, alpha channel of specular maps can be used to set the reflection intensity.
 +
***'''Category:''' Graphics.
 +
***'''See:''' [[Command-Line_Reference#-env]], [[Command-Line_Reference#-alpha_env]], [[Texturing]], [[Command-Line_Reference#-spec]] 
 +
***'''Usage Tips:'''
 +
 +
=====Former builds=====
 +
* '''YYYY-MM-DD'''. Unknown date:
 +
**<font color=red>'''OpenGL support'''</font>
 +
***'''Description:''' The game has been ported from original DirectX to OpenGL API. Moreover, DirectX is depreciated and can become unsupported in future versions.
 +
***'''Category:''' Graphics.
 +
***'''See:'''
 +
***'''Usage Tips:'''
 +
**<font color=red>'''Modular Tables'''</font>
 +
***'''Description:''' [[TBM|*.TBM]] modular tables allow partial modifications over [[TBL|*.TBL]] standard tables.
 +
***'''Category:''' Tables and modding.
 +
***'''See:''' [[Modular Tables]]
 +
***'''Usage Tips:'''
 +
**'''Launcher flags'''
 +
***'''Description:''' Some of the new fs2_open and FRED2_open features are switched on through command line parameters. They can also be set through Launcher utility.
 +
***'''Category:''' Coding.
 +
***'''See:''' [[Command-Line Reference]]
 +
***'''Usage Tips:'''
 +
**<font color=red>'''-MOD flag'''</font>
 +
***'''Description:''' It allows the usage of extra game data folders inside FS2 main folder. It is mainly used to avoid undesired mod data cross-effects.
 +
***'''Category:''' Tables and modding.
 +
***'''See:''' [[Command-Line Reference#-mod]], [[FS2 Data Structure]]
 +
***'''Usage Tips:'''
 +
**'''Enhanced texture support'''
 +
***'''Description:''' The game now supports [[Wikipedia:Truevision TGA|*.TGA]], [[Wikipedia:JPG|*.JPG]] and [[Wikipedia:DirectDraw Surface|*.DDS]] textures. There's also a new format for animated textures &mdash; [[EFF|*.EFF]].
 +
***'''Category:''' Tables and modding, Graphics.
 +
***'''See:''' [[Texturing]], [[Command-Line Reference#-jpgtga]]
 +
***'''Usage Tips:'''

Revision as of 18:40, 17 July 2007

WARNING: THIS PAGE IS BEING DESIGNED

This section is just now being built and designed. Please wait a little before real posting inside it or its linked pages and subsections.

Now the main target is deciding how the page should look and which sections it should contain.

Please post your comments in this forum thread: [1]

At the beginning, I thought about two related lists: One sorted by Date and another by category. But I feel that posting and linking them can be quite tedious. So now I've rebuilt an alternative list just sorted by date but with Category looking.

Please take a look and post your suggestions.



1st possible structure. Two linked lists

Introduction

The main thing the Source Code Project do is adding features to the retail game engine. BLA, BLA, BLA

SCP Additions: List by Date

SCP Additions: List by Category

Posting Rules

Please follow the rules. Even if you don't agree with some of them, follow them. This section can grow huge and it can become a damn hell. So we need one and only set of rules. And we all must follow it.

No discussion here, please.


  1. 1st. GOLDEN RULE: Be extremely brief.
    • Do not make long explanations within the lists.
    • In each entry Description section write a brief explanation.
    • If you need a deeper explanation for that feature put a link, (or links), in See section. Even create new pages if needed.
  2. 2nd. GOLDEN RULE: Be extremely tidy.
  3. SCP Additions: List by Date posting rules.
    1. As they should be quite intuitive, please follow any other example you find here.
    2. This list is actually two lists:
      • Features that belong only to HEAD experimental builds.
      • Features that belong also to stable builds. This kind of features are also present in HEAD builds. These builds are the seed for official SCP releases (like 3.6.9).
    3. Be sure you know if the feature must go to HEAD Branch or Stable Branch.
    4. Be extremely tidy in the place and date you post. The list should be always kept sorted in descending date order (the most recent additions should go in the upper part of each section).
    5. If the CVS date for your feature doesn't exist, create a new one. Use Japanese YYYY-MM-DD format. So January 27th in 2007 should be 2007-01-27. (In this way the number of the date always grows when a day advances).
    6. Once you have located or created your date, post the feature as a sublist entry on that date:
    7. If your feature is upgraded from the HEAD to the stable branch, please move it to that section, update the dates and also update SCP Additions: List by Category added date.
  4. SCP Additions: List by Category posting rules.
    1. Please follow any other example you find here.
    2. Each feature here is a sub-sub-sub section. Ie., each new feature entry goes between ==== and ==== to make it appear in the Contents box at the top of the page.
    3. Each entry has four sections:
      • Description: A brief description of the feature.
      • Added in: Post the build or the date if known. If it is experimental write HEAD only. Examples:
        • Added in: 2006-12-28
        • Added in: 3.6.9.
        • Added in: 2006-12-28 HEAD only
      • See: Put the links here to related pages with deeper info about that feature. If you want to post a lot of info about your feature, create your own page and put the link here.
      • Usage Tips: In the future, creating a tips page somewhere in the Wiki is intended. In this section you could explain useful tricks. Put here the links to the tips this feature is useful for here.
        If you feel like it, you can even start that tricks page ;) . Some discussion can be found here.
    4. Please try to put every feature in the category you think that suits better. Even you can put it in two or more categories if you feel like it. But in this situation follow the next steps:
      • Only fill the four sections (Description, Added in, See and Usage Tips) in one of them. This would be the main one.
      • In the others, you will use the same name but ending with "(repeated)", "(repeated 2)" and so on. The main reason to do this is avoiding conflictive entries with exactly the same name.
      • In these secondary entries, just put a See section with a link to the main entry.
      • A "fake" example:
        • Mission features
          ...
          • Feature AA. (This would be the main one)
            • Description: Whatever...
              ...
            • Usage Tips:
          • Feature BB
            ...
        • Graphics
          ...
          • Feature AA (repeated). (This would be the secondary one)
            • See: Here you'd have a link to Feature AA
          • Feature XX.
            ...
    5. If you want you can use the next colour code to tell the addition importance:
      • Critical update. (This would be an extremely important update over retail behaviour).
        • Description: Whatever...
          ...
        • Usage Tips:
      • Common update. (Normal updates).
        • Description: Whatever...
          ...
        • Usage Tips:
      • Just a tweak. (This would be just a tweak over retail Freespace2).
        • Description: Whatever...
          ...
        • Usage Tips:


2nd possible structure. Just sorted by date (but, more or less, with old category list looking)

Introduction

BLA, BLA, BLA

Posting rules

Please follow the rules. Even if you don't agree with some of them, follow them. This section can grow huge and it can become a damn hell. So we need one and only set of rules. And we all must follow it.

No discussion here, please.


  1. 1st. GOLDEN RULE: Be extremely brief.
    • Do not make long explanations within the lists.
    • In each entry Description section write a brief explanation.
    • If you need a deeper explanation for that feature put a link, (or links), in See section. Even create new pages if needed.
  2. 2nd. GOLDEN RULE: Be extremely tidy.
    • As you can imagine, this Wiki section can become a mess quite easily.
    • Always check that all the links work.
  3. General posting rules.
    1. As they should be quite intuitive, please follow any other example you find already posted.
    2. This list is actually two lists:
      • Features that belong only to HEAD experimental builds.
      • Features that belong also to stable builds. This kind of features are also present in HEAD builds. These builds are the seed for official SCP releases (like 3.6.9).
    3. Therefore, be sure you know if the feature must go to HEAD Branch or Stable Branch.
    4. Be extremely tidy in the place and date you post. The list should be always kept sorted in descending date order (the most recent additions should go in the upper part of each section).
    5. If the CVS date for your feature doesn't exist, create a new one.
    6. Always use Japanese YYYY-MM-DD format. So January 27th in 2007 should be 2007-01-27. (In this way the number of the date always grows when a day advances).
    7. Each new date should be a list item, ie. start it with *
      1. Each new feature in a given date should be a sublist item, ie. start it with **
      2. Each new feature has four sections. These subsections are sub-sublist items, ie. start them with ***:
        • Description: A brief description of the feature.
        • Category: The game category this feature falls in. It can be useful for people that want to look for just new "Sound" features for example. Please check the spelling and do not invent new categories. If you type "suond" or if we have one thousand different categories, this field is useless.
          You can assign several categories if you feel the feature you are posting about can fall in several areas.
          The official categories are:
          WARNING: We have to decide exact category names too ...
          • Mission features. All the new stuff you can add to missions through FRED, ie. new sexps, backgrounds, new mission options, ...
          • FRED interface. Any other FRED improvements, like Voice Acting Manager, which don't fall in the previous one.
          • Graphics. All the extra graphical capabilities added like OGL support, shine, glow, env or normal mapping...
          • Sound. Just the same with sound and music (ogg support as example).
          • Game interface. F3 Lab, showing models in loadout screen, showing ship info in hud, extended hud capabilities...
          • Models. Everything that has to do with ship models like higher poly limits, glow points...
          • Tables and modding. Everything that allows modders to customize FS2 and it's not directly set in FRED as a mission feature. Examples: Data management (-MOD flag), extended texture format support, modular tables, "un-hardcoded" tables like iff_defs, 3D shockwaves, 3D warp effects...
          • Scripting. (I know nothing about it)
          • Multiplayer. (I know nothing about it, again)
          • Coding. Technical coder info which maybe is not directly seen in game but needs to be told. Like "I have changed all the arrays with pointers in this subroutine". (Sorry if I'm telling nonsenses but I'm no coder at all, I think you can imagine what I want to say).
        • See: Put the links here to related pages with deeper info about that feature. If you want to post a lot of info about your feature, create your own page and put the link here.
        • Usage Tips: In the future, creating a tips page somewhere in the Wiki is intended. In this section you could explain useful tricks. Put here the links to the tips this feature is useful for here.
          If you feel like it, you can even start that tricks page ;) . Some discussion can be found here.
    8. If your feature is upgraded from the HEAD to the stable branch, please move it to that section and update the dates
    9. If you want you can use the next colour code to tell the addition importance:
      • Critical update. (This would be an extremely important update over retail behaviour).
        • Description: Whatever...
          ...
        • Usage Tips:
      • Common update. (Normal updates).
        • Description: Whatever...
          ...
        • Usage Tips:
      • Just a tweak. (This would be just a tweak over retail Freespace2).
        • Description: Whatever...
          ...
        • Usage Tips:
    10. When a new official release appears, Stable > CVS subsection name is just changed to the new build denomination and a new Stable > CVS section is created.



Feature list sorted by date

HEAD Branch (CVS) - Experimental, non-canon features

Stable Branch

CVS
3.6.9. build
Former builds
  • YYYY-MM-DD. Unknown date:
    • OpenGL support
      • Description: The game has been ported from original DirectX to OpenGL API. Moreover, DirectX is depreciated and can become unsupported in future versions.
      • Category: Graphics.
      • See:
      • Usage Tips:
    • Modular Tables
      • Description: *.TBM modular tables allow partial modifications over *.TBL standard tables.
      • Category: Tables and modding.
      • See: Modular Tables
      • Usage Tips:
    • Launcher flags
      • Description: Some of the new fs2_open and FRED2_open features are switched on through command line parameters. They can also be set through Launcher utility.
      • Category: Coding.
      • See: Command-Line Reference
      • Usage Tips:
    • -MOD flag
      • Description: It allows the usage of extra game data folders inside FS2 main folder. It is mainly used to avoid undesired mod data cross-effects.
      • Category: Tables and modding.
      • See: Command-Line Reference#-mod, FS2 Data Structure
      • Usage Tips:
    • Enhanced texture support