Wie wende ich die Dokumentation von SDL und generell richtig an?



  • Nun, damit ich hier nicht tausend Fragen stellen muss, stelle ich mir lieber die Frage wie ich solche Dokumentationen richtig anwende.

    Es geht um Verstehen von Datentypen, wie sie aufgebaut und strukturiert sind.

    z.b. lese ich mir den Befehl SDL_SetCursor.
    Synopsis (aus SDL doc)

    void *SDL_SetCursor(SDL_Cursor *cursor);
    

    Es erwartet ein Argument vom Typ SDL_Cursor

    doch ich weiss nicht aus was SDL_Cursor besteht und was für ne Strukturierung.
    es ist kein link, unter See Also auch nix

    nur wenn ich mit windows-suche unter Begriffe suche
    dann finde ich eine Datei aus dem Suchergebnis SDL_mouse.h und da finde ich

    typedef struct SDL_Cursor {
    	SDL_Rect area;			/* The area of the mouse cursor */
    	Sint16 hot_x, hot_y;		/* The "tip" of the cursor */
    	Uint8 *data;			/* B/W cursor data */
    	Uint8 *mask;			/* B/W cursor mask */
    	Uint8 *save[2];			/* Place to save cursor area */
    	WMcursor *wm_cursor;		/* Window-manager cursor */
    } SDL_Cursor;
    

    sollte so etwas nicht auch in der Dokumentation stehen? wenn ich jetzt nach Uint8 suchen will, kommen Hunderte von Dateien aus den Suchergebnissen, die ich rumsuchen muss. Ist doch doof.

    gut ich weiss jetzt dass uint8 ein unsigned int 2*8 ist
    aber jemand der NUR grundlagen c++ gelernt hat und kein internetanschluss hat, wird das wohl nicht wissen? nu was ist jetzt Sint16 ? wobei ich das jetzt erraten kann



  • merke:
    wenn du eine funktion benutzen willst in die etwas reinkommt das du nicht hast, suchst du eine funktion wo das rauskommt was du brauchst 🙂

    wenn du nichts findest, gibst du den begriff in google ein.
    der erste link fuehrt dich hier hin. bingo!



  • hey! dass wikibooks auch SDL Artikeln hat, wusste ich gar nicht !



  • offizielle Doku zu SetCursor:
    http://www.libsdl.org/cgi/docwiki.cgi/SDL_5fSetCursor

    Und ganz unten auf der Seite unter "see also" ist auch die korrekte Funktion zum erzeugen eines Cursors: http://www.libsdl.org/cgi/docwiki.cgi/SDL_5fCreateCursor

    Hast du wohl uebersehen 😉


Anmelden zum Antworten