Computer graphics -- 2007-2008 -- info.uvt.ro/Subversion repository

These pages are somehow outdated and it is recommended to consult the newer version at Computer graphics -- 2008-2009 -- info.uvt.ro (by Marc Frâncu).

Quick links: front; laboratories agenda, 1, 2, 3, 4, 5, 6, 7, 8, evaluation, tools, repository.

Purpose

All your source code and needed data (libraries, textures, files) (or in case of an essay the documents) for an assignment should be placed in the Subversion repository provided by us.

The usage of the Subversion repository has the following advantages:

you can access the examples or your assignments from anywhere -- provided that you have an SVN client installed and access to the Internet (and provided that you are not firewalled);
it eliminates the needles hassle with assignments sent by email, thus eliminating the zipping, unzipping, upload, download, etc.;
it eases the assignment evaluation procedure by removing the need to collect all the assignments in one common place;
it will provide a good experience with versioning tools that today are almost ubiquitous in the enterprise world -- and SVN is the most used system;

Usage

In order to use the repository you need the following information:

the URL: svn://hephaistos.info.uvt.ro/info/2007-2008/computer-graphics
an username and password: this should have been sent to you by email;
a client application or plugin:
- as we use Eclipse IDE, we shall also use Subclipse plugin; please consult User:Ciprian Dorin Craciun/Tools/Subclipse;
- for a complete collection of clients please consult User:Ciprian Dorin Craciun/Tools/Subversion#Clients;

You should also be familiar with the clients and plugins:

for Subclipse tutorials you could consult: User:Ciprian Dorin Craciun/Tools/Subclipse#Tutorials;
for some tutorials please consult: User:Ciprian Dorin Craciun/Tools/Subversion#Tutorials;
for books about Subversion please consult: User:Ciprian Dorin Craciun/Tools/Subversion#Books;

Please be careful about the username. In our case the username is all lower-case letters, and some clients pre-fill the username with the current operating system user. If the casing differs please correct, or else you will encounter SVN authorization errors. If you have made this mistake, then you must find the folder Documents and settings / your folder / Application data and here identify the Subversion folder which you should delete. After this restart Eclipse and carefully reenter the username and password.

Repository layout

Each student has at its disposal a folder which contains subfolders for every assignment. Thus the assignments should be placed only in these subfolders.

Example repository layout:

<root> -- the root folder of the entire repository
- en3 -- the study year
  - username -- the username obtained through email
    - assignment-01 -- the root folder of the first assignment
      - .classpath -- Eclipse generated file
      - .project -- Eclipse generated file
      - src -- the Java sources
      - lib -- needed Jars
      - ...

You should never attempt to checkout the entire repository. Usually you should only checkout the specific folder for an assignment (like assignment-01).

Subclipse short tutorial

This is a small guide that will guide you into using Subclipse plugin together with Eclipse. It covers:

plugin installation;
initial assignment checkout;
assignment commit;

Installation

Please consult: User:Ciprian Dorin Craciun/Tools/Subclipse/Installation.

Checkout

select File -> New -> Other menu;

find the folder SVN in the wizard; if such a node does not exist, it means that you don't have Subclipse installed, and you should see the installation procedure;
under this folder select Checkout projects from SVN;
press Next;

choose the option Create new repository location only if you don't have the URL in the list below this option;
choose the option Use existing repository location if the URL is in the list below;
press Next;

this step is available only if you have chosen the option Create new repository location ;
enter inside the URL textbox, the URL of the repository; in our case it is svn://hephaistos.info.uvt.ro/info/2007-2008/computer-graphics
press Next;

if asked for an username and password enter them; (the username and password should have been sent to you by email;)
Please be careful about the username. In our case the username is all lower-case letters, and some clients pre-fill the username with the current operating system user. If the casing differs please correct, or else you will encounter SVN authorization errors. If you have made this mistake, then you must find the folder Documents and settings / your folder / Application data (which could be hidden so you should resort to the address bar) and here identify the Subversion folder which you should delete. After this restart Eclipse and carefully reenter the username and password.
check the option Save password;
press Ok;

find the folder specific for each assignment or example;
you should checkout only folders named like assignment-n or example-n; never attempt to checkout the root folder, the examples, folder, or your folder as it will break Eclipse;
press Next;

if this is the first time when you download the folder you should select the Check out as project configured using New Project Wizard option;
if you already have uploaded the assignment and want to checkout once more you should select the Check out as a project in the workspace option;
press Finis;

this step applies only if you have chosen the option Check out as project configured using New Project Wizard;
find the option Java project either at the top of the list, or inside the folder Java;
press Next;

this step applies only if you have chosen the option Check out as project configured using New Project Wizard;
give a name to the new project (for example you could use assignment-01, etc.) by filling the Project name textbox;
press Finish;