int SDL_UpdateTexture(SDL_Texture*    texture,
                      const SDL_Rect* rect,
                      const void*     pixels,
                      int             pitch)

Zwraca 0 przy sukcesie lub ujemny kod błędu przy niepowodzeniu; wywołaj funkcję SDL_GetError(), aby otrzymać więcej informacji na temat błędu.

Dane pikselowe muszą być w formacie pikseli tekstury. Użyj funkcji SDL_QueryTexture(), aby sprawdzić format pikseli tekstury.

Funkcja jest dosyć wolna, przeznaczona do użytku ze statycznymi teksturami, które nie zmieniają się zbyt często.

Jeśli tekstura ma być uaktualniana często, to lepiej utworzyć teksturę strumieniową i użyć funkcji blokujących przedstawionych poniżej. Chociaż ta funkcja będzie działać z teksturami strumieniowymi, to z powodów optymalizacji możesz nie otrzymać pikseli z powrotem, jeśli później zablokujesz tą teksturę.

SDL_CreateTexture
SDL_LockTexture
SDL_UnlockTexture