Genlib v1.00 Alpha - Documentation - Page 1

Si vous pouviez m'aider a relire la documentation de genlib et relevez les erreurs, ca serait vraiment sympa:

Version HTML: ~technic/archives/Recent%20Upload/genlib.html
Version PDF: ~technic/archives/Recent%20Upload/genlib.pdf

(Si vous devez en imprimer une, choisissez la version PDF )

Attention la doc n'est pas petite

long genlib::sprite_tile_adr Global ASM Variable
word: genlib::sprite_scr_x Global ASM Variable
word: genlib::sprite_scr_y Global ASM Variable
sprite_tile_adr is the address of the SPRITE16 array used by

sprite_scr_x and sprite_scr_y are the coordinates X,Y of the virtual sprite-plane. It is used by all sprite functions execpt fast-sprite ones.
You cannot access theses variables in C, so you should instead the functions

Tu as du oublier de terminer la dernière phrase je pense.


Dans la description de gl_set_screen_int, tu ne précises pas à quoi sert le screen2 sur HW1.

It puts a Bgs on the Working DScreen with halo and with horizontal flipping. It clips the sprite if it is outside the screen. You must provide a buffer big enought
for the flipped sprite

Il me semble qu'il n'y a pas de t à enough. Cette erreur est partout où tu emploies le mot enough.

Each element of the matrix represents a tile in the array of the
tile.

J'enlèverais le "the" de la fin.

PLANE *gl_init_plane (const unsigned char
*map, const SPRITE_16 *tile, unsigned short sizeX) Function C

Les maps peuvent être des matrices de short, donc peut-être qu'il faudrait mettre "const void *", mais je ne sais pas si c'est correct en C.

It is usefull if you want that your sprites were drawn according to the position of the Planem
which is usually the case.

Le m est en trop ?

It returns a non-null value iff
a key is pressed.

Un f de trop.

(I dond
't know the offical name).

...

5.10 C only Functions Theses functions are usefull for ASM programmers.

Contradiction. C'est "for C programmers" qu'il faut mettre.


Les fonctions de glaux dessinent où ?


Et il manque l'historique

Voilà, c'est tout ce que j'ai vu, j'ai peut-être lu un peu rapidement certains passages...

Corrige.

J'ai edité mon post, rajouté qq trucs.

>Un f de trop.
Nan. C'est la contraction de if and only if.

>Et il manque l'historique
Il est pas beau mais il y est, non ?

Corrige et mise a jour des fichiers en lignes. Moi je les lirai demain (Ras le bol %&(#*&%(*#%&(&)

Encore quelques corrections orthographiques de plus.

genlib 1.0 qui approche ?

sprite_tile_adr is the address of the SPRITE16 array used by

manque la fin de la phrase ?
(doc de genlib::sprite_tile_adr)

gl_flipping_tab[%01110001] = %10001110

En C (ça ressemble à du C), ce n'est pas % qui est utilisé pour le binaire, mais 0b

pour gl_create_bgs_string, il me semble qu'il n'est pas précisé avec quelle fonte (petite, moyenne, grande) le BGS est créé

string is the formated text to displayed.

to display, plutot, non ?
(doc de glaux_text)

Bon j'ai tout imprimé, lirai ça cette semaine #débordé#

squale92
:

gl_flipping_tab[%01110001] = %10001110

En C (ça ressemble à du C), ce n'est pas % qui est utilisé pour le binaire, mais 0b

Soit dit en passant que c'est une extension TIGCC.

Corrige. Merci squale.

Remise a jour de la doc avec de nouvelles corrections orthographiques. Mais je reste confiant dans le nombre restant de fautes.

./12 > de rien

Je suis en train de corriger de nombreuses typos (et des phrases qui ne veulent rien dire).
N'empeche que cette nouvelle doc est vraiment mieux que l'ancienne

Erf, tu m'étonnes

rien que le pdf est une bonne idee, ca sera super pratique d'avoir une version papier avec soi

Vous voulez aussi une version INFO ?

Remise a jour avec corrections de typos et reecriture de phrases qui ne voulaient rien dire.

question conne, tu uploades les modifs a la meme adresse a chaque fois ?

Oue.

286866 Nov 9 11:52 genlib.html MD5: c71cb8e9ad895b48c75b083eac9b1eff
413964 Nov 9 11:52 genlib.pdf MD5: dbe86d98476fae63b8c5ffd48d2b32bd

bah je me suis imprimé le pdf hier

Y'a juste eu des corrections orthographiques.

et, à tout hasard, à quand la possibilité de télécharger la lib elle-même ?
(et les exemples (me semble qu'il y en avait dans les anciennes versions))

ah, aussi, un truc que j'ai pas trouvé super clair
(mais bon, j'ai pas trop cherché non plus ; notamment, j'ai pas encore codé avec)
les fonctions gl_aux_*, il est dit qu'elles ne sont pas dans la lib dynamique, mais dans la lib statique. est-ce que cela signifie qu'on ne peut les utiliser que si on code en nostub avec gennlib ? ou est-ce qu'on peut aussi les utiliser si on code avec genlib en dynamique ?
(l'idéal serait qu'on puisse les utiliser dans les deux cas, et je pense que c'est le cas... mais j'en suis arrivé à ça en réfléchissant... ça me paraisssait pas très clair à la lecture de la doc)


d'ailleurs, une phrase pas très claire (intro de la doc des gl_aux) :

Theses functions aren't in genlib (The dynamic library) but in genlib the static library.

le second "genlib", est-il vraiment utile ?

>et, à tout hasard, à quand la possibilité de télécharger la lib elle-même ?
Lors de la future release
Mais y'aura surement des RC avant (Je me tate pour faire des RC publiques comme pour Preos 0.71 ou privees).

>(et les exemples (me semble qu'il y en avait dans les anciennes versions))
Dans la release.

>les fonctions gl_aux_*, il est dit qu'elles ne sont pas dans la lib dynamique, mais dans la lib statique.
Oui et c'est glaux_*

>est-ce que cela signifie qu'on ne peut les utiliser que si on code en nostub avec gennlib ?
Non. Y'a aussi une genlib statique kernel

> ou est-ce qu'on peut aussi les utiliser si on code avec genlib en dynamique ?
Nostub ou kernel, genlib reste dynamique.

J'ai eclarcit:

Theses functions aren't in the dynamic library of GENLIB but in
the static one (genlib.a or gennlib.a).
You can use still use theses functions in nostub or kernel
mode. Since they are pure C functions, I just do a preview
of them. Some extra structures are defined too:

OK
merci.

peut-être que quelque part, il serait bon de préciser que genlib est à la fois une librairie dynamique, et un librairie statique ?
de façon à éviter que les programmeurs ne se disent qu'ils ne peuvent utiliser _que_ la librairie dynamique, ou _que_ la librairie statique, et à ce qu'ils comprennent bien que la librairie dynamique est toujours utile, y compris en mode nostub (relogement de la lib dynamique fait par la lib statique).
(enfin, j'ai regardé dans la partie "installing genlib", et j'ai rien trouvé qui dise quoique ce soit de ce genre)

ah, aussi, il n'est pas possible d'utiliser la version nostub en assembleur ?
(les explications quant à l'utilisation de genlib en nostub sont dans la partie "installing genlib for C programmers" (1.3), et il n'y a rien à ce sujet dans la partie 1.2 relative aux codeurs ASM

Deja que je compte enlever le mode nostub de la doc... (Plus legeres corrections de la doc).

enlever le mode nostub de la doc ?
en le laissant dans la lib, tout de meme ?

Disons qu'il est buggue a l'heure actuelle et comme tout le monde s'en fout (cf vote).