Repository Reference/Key Concepts

From Blood Wiki
(Difference between revisions)
Jump to: navigation, search
(Development vs Release)
 
(2 intermediate revisions by one user not shown)
Line 1: Line 1:
 
{{navigation title|Introduction}}
 
{{navigation title|Introduction}}
{{grammar}}
+
{{grammar checked|darth}}
 
==Development vs Release==
 
==Development vs Release==
 
Blood Omnicide release version is different from what you get in repository.  
 
Blood Omnicide release version is different from what you get in repository.  
Line 19: Line 19:
  
 
==Linked to Blood Omen==
 
==Linked to Blood Omen==
By just downloading a working copy of repository you dont get a working game. Since Blood Omnicide is a port, it heavily depends on original game media files.  
+
By just downloading a working copy of repository you don't get a working game. Since Blood Omnicide is a port, it heavily depends on original game media files.  
  
Blood Omen files got copied when Blood Omnicide release version is being installed on a computer. Development version doesnt have such installer, but it have a '''test installation script''' that does the same job. The process of getting a working copy of Blood Omnicide is called '''test installation'''.
+
Blood Omen files got copied when Blood Omnicide release version is being installed on a computer. Development version doesn't have such installer, but it has a '''test installation script''' that does the same job. The process of getting a working copy of Blood Omnicide is called '''test installation'''.
  
 
==Sources are saved==
 
==Sources are saved==
All media file sources get saved to SVN, including source files for tools, textures and models. The only reason some source file dont get saved, is when it's size are too big (>100Mb). Sources are saved in the same folder as their exported files. The code sources doesnt need an futher explanation, but textures and models apparently are:
+
All media file sources get saved to SVN, including source files for tools, textures and models. The only reason a source file doesn't get saved is when its size is too big (>100Mb). Sources are saved in the same folder as the exported files. The code sources don't need a further explanation, but textures and models apparently do:
  
 
'''Texture sources'''
 
'''Texture sources'''
:Source are the base image (PSD or whatever) you are exporting to [[TGA]] texture.
+
:Source is the base image (PSD or whatever) you are exporting to [[TGA]] texture.
  
 
'''Model sources'''
 
'''Model sources'''
:This have alot of variations. For static models it is best to save sources as [[ASE]] files, if models are animated, store whatever source file you have (MAX, blend etc.)
+
:These have a lot of variations. For static models it is best to save sources as [[ASE]] files, if models are animated, store whatever source file you have (MAX, blend etc.)
  
 
==Common conventions==
 
==Common conventions==

Latest revision as of 17:37, 11 October 2012

Repository Reference | previous chapter: Introduction

Contents

[edit] Development vs Release

Blood Omnicide release version is different from what you get in repository.

For development version:

  • All files are real files (except for test installation)
  • All textures are uncompressed, DDS cache is optional
  • Sources and development files included
  • SDK and tools included

In release version:

  • All files packed into game archives
  • Textures are compressed (DDS cache only)
  • Source files and development files are deleted
  • SDK in separate download

Release version for the game is about 800 Mb and has shorter loading times.

[edit] Linked to Blood Omen

By just downloading a working copy of repository you don't get a working game. Since Blood Omnicide is a port, it heavily depends on original game media files.

Blood Omen files got copied when Blood Omnicide release version is being installed on a computer. Development version doesn't have such installer, but it has a test installation script that does the same job. The process of getting a working copy of Blood Omnicide is called test installation.

[edit] Sources are saved

All media file sources get saved to SVN, including source files for tools, textures and models. The only reason a source file doesn't get saved is when its size is too big (>100Mb). Sources are saved in the same folder as the exported files. The code sources don't need a further explanation, but textures and models apparently do:

Texture sources

Source is the base image (PSD or whatever) you are exporting to TGA texture.

Model sources

These have a lot of variations. For static models it is best to save sources as ASE files, if models are animated, store whatever source file you have (MAX, blend etc.)

[edit] Common conventions

A number of rules that should be followed in order to keep repository clean.

Files names

All files, folders, file extensions must be lowercase with all-latin characters and with no spacers. Failing this rule can throw a number of problems like limited portability and SVN errors.

Commits

Dont commit files no one will use. SVN is not a light version of FTP. It stores all file versions, even if it was deleted. So abusing it with many unused files will waste HDD space.



Next chapter: Building a Game
Back to index | Top of the page

Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox