STATE_utilities_cut_image

 

 


   Divides a bitmap into smaller pieces (image cutter)
  
   Parameters:
  
  		bitmap_to_cut: 
  			a bmp file name
  
  		fraction_width, fraction_width:
  			The size of the each small fraction cut from the big bitmap
  
  		name_to_save:
  			The path\filename where to save the fractions.
  			example: "D:\\my_folder\\filename" this will create the bitmaps inside the folder "my_folder"
  			and will name them filename1.bmp, filename2.bmp etc ...
  			
  		force_8bit_output
  			The fractions are saved in 8bit format.
  
  
   Return value:
  		Returns the number of bitmaps that were created.		
  
  
   Example:
  
  		  This will divide a big bitmap into 256x256 parts
  		STATE_utilities_cut_image("big_bitmap.bmp", 256, 256, "part", NO);
  
  	Remarks:
  		Almost all 3d cards cant handle bitmaps larger than 1024x1024
  		The Voodoo3 card can handle only 256x256 bitmaps (or smaller) !!!
  
  		Many 3d cards achieves best performance when bitmaps are at the size of 256x256
  		Though in some application 512x512 or 1024x1024 will get better results
  		depending on the application developed (you should test it to get suitable size for your application)
  

 

 

Go to page 1      Select API

 

Copyright © 2007 3DSTATE Corporation. www.3dstate.com