BBitmapStream

Provient de : public BPositionIO

Declaré dans : be/translation/BitmapStream.h

Librairie: libtranslation.so

Sommaire

BBitmapStream convient pour une conversion facile d'un objet translator bitmap, le format bitmap par défaut du kit de conversion, vers un objet BBitmap. C'est une sous classe très limitée de la classe BPositionIO seulement capable de lire et d'écrire des conversions de bitmaps; exécuter des e/s sur l'objet avec d'autres types de données peut produire d'étranges résultats. Le seul attrait de cette classe est la méthode DetachBitmap(), qui retourne le contenu de l'objet sous forme de BBitmap.

La plupart du temps,vous n'aurez pas à utiliser l'objet BBitmapStream directement; BTranslationUtils contient les fonctionnalités nécessaires pour charger des images à partir de fichiers, de ressources, ou d'objets BPositionIOs dans des objets BBitmaps.

Le programme suivant illustre l'usage courant de la classe BBitmapStream sans contrôle d'erreurs:

   BBitmap *FetchBitmap(char *filename)
   {
      BFile file(filename, B_READ_ONLY);
      BTranslatorRoster *roster = BTranslatorRoster::Default();
      BBitmapStream stream;
      BBitmap *result = NULL;
      if (roster->Translate(&file, NULL, NULL, &stream, 
            B_TRANSLATOR_BITMAP) < B_OK)
         return NULL;
      stream.DetachBitmap(&result);
      return result;
   }

Vous pouvez également initialiser la classe avec un objet BBitmap et l'utiliser en paramètre d'entrée de BTranslatorRoster::Translate() pour la sauver dans un format différent:

   void StoreTranslatorBitmap(BBitmap *bitmap, char *filename, uint32 type)
   {
      BTranslatorRoster *roster = BTranslatorRoster::Default();
      BBitmapStream stream(bitmap); // initialisation avec le contenu de la bitmap
      BFile file(filename, B_CREATE_FILE | B_WRITE_ONLY);
   
      roster->Translate(&stream, NULL, NULL, &file, type);
   }

Constructeur et Destructeur

BBitmapStream()

	BBitmapStream(BBitmap *map = NULL)

Crée une nouvelle instance de l'objet BBitmapStream. Si map est NULL, le flux est initialisé à vide. Autrement, l'objet BBitmap est converti en bitmap de conversion et placé dans le flux de données. L'application partage l'objet BBitmap avec l'objet BBitmapStream. Par conséquent, il ne peut y avoir suppression de l'objet BBitmap avant d'avoir appelé la méthode DetachBitmap().

~BBitmapStream()

	~BBitmapStream()

Libère la mémoire allouée par l'objet BTranslatorRoster.

Fonctions Membres

DetachBitmap()

	status_t DetachBitmap(BBitmap **outMap)

Retourne, dans outMap, un objet BBitmap représentant l'image contenue dans BBitmapStream. Une fois que DetachBitmap() a été appellée, plus aucune opération ne peut être exécutée sur l'objet BBitmapStream.

CODES DE RETOUR

• B_NO_ERROR. Succès.

• B_BAD_VALUE. outMap est NULL.

• B_ERROR. Il n'y a pas d'objet BBitmap disponible.

Position() , ReadAt() , Seek() , SetSize() , WriteAt()

	off_t Position() const ssize_t ReadAt(off_t pos, void *buffer, size_t *size) off_t Seek(off_t position, uint32 whence) status_t SetSize(off_t size) const ssize_t WriteAt(off_t pos, const void *data, size_t *size)

Ces méthodes fournissent l'implémentation de l'objet BPositionIO. Ces fonctions sont identiques à celles de l'objet BPositionIO à l'exception de ReadAt() et de WriteAt(), qui lisent et écrivent seulement des bitmaps de conversion comme décrit dans l'introduction.

Voir également : BPositionIO

Size()

	off_t Size() const

Retourne la taille de bitmap de conversion dans le flux de données.