0% encontró este documento útil (0 votos)

1K vistas220 páginas

Manual Español - Blitz3D

Este documento proporciona una introducción y descripción de varios comandos y estructuras condicionales en Blitz Basic 3D, incluyendo IF, THEN, ELSE, ELSEIF, END IF, SELECT, CASE, DEFAULT y END SELECT. Explica cómo usar estas herramientas para comprobar condiciones y ejecutar código dependiendo de los resultados de las comparaciones lógicas.

Cargado por

Benyto Kamikaze Mitnick Richtöfen

Derechos de autor

Nos tomamos en serio los derechos de los contenidos. Si sospechas que se trata de tu contenido, reclámalo aquí.

Formatos disponibles

Descarga como PDF, TXT o lee en línea desde Scribd

0% encontró este documento útil (0 votos)

1K vistas220 páginas

Manual Español - Blitz3D

Cargado por

Benyto Kamikaze Mitnick Richtöfen

Derechos de autor

Nos tomamos en serio los derechos de los contenidos. Si sospechas que se trata de tu contenido, reclámalo aquí.

Formatos disponibles

Descarga como PDF, TXT o lee en línea desde Scribd

Está en la página 1/ 220

AYUDA BLITZ BASIC 3D

NDICE
2D - Categoras Bsico Matemticos Cadenas Texto Entrada Banco Ficheros Ficheros/Flujos Network TCP (Network) UDP (Network) DirectPlay DirectShow Sonido/Msica Grficos Imagen Tiempo Windows/Debug Pag. 2 21 31 36 40 51 55 61 70 71 73 75 86 87 93 111 131 133 3D - Categoras Global Textura Pincel Malla Superficie Cmara Luz Pivote Sprite MD2 BSP Plano Espejo Terreno Oyente/Sonido Movimiento de Entidades Animacin de Entidades Control de Entidades Estado de Entidades Colisin de Entidades Modo Grfico Pag. 137 146 154 158 166 170 177 178 178 179 183 184 185 186 195 195 201 203 207 214 219

SCANCODES
TECLA DEL TECLADO ESCAPE 1 2 3 4 5 6 7 8 9 0 Menos (-) Igual (=) Backspace Tab Q W E R T Y U I O P Corchete Izq. ([) Corchete Der. (]) Intro Control Izq A S D F G H J K L Punto y coma (;) Apstrofe (') Grave Shift Izq Barra invertida (\) Z X C V B N M Coma (,) Punto (.) Barra (/) Shift Der Asterisco (*) Alt Izq/Men SCANCODE 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 COMENTARIOS TECLA DEL TECLADO Espacio Capital F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 NumLock Scroll Lock NumPad 7 NumPad 8 NumPad 9 Menos (-) NumPad 4 NumPad 5 NumPad 6 Ms (+) NumPad 1 NumPad 2 NumPad 3 NumPad 0 Punto (.) OEM_102 F11 F12 F13 F14 F15 Kana ABNT_C1 Accent Grave Convert NoConvert Yen ABNT_C2 SCANCODE 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 86 87 88 100 101 102 112 115 121 123 125 126 COMENTARIOS TECLA DEL TECLADO Stop AX Unlabeled Next Track Intro Control Der Mute Calculator Play/Pause Media Stop Volume Down Volume Up Web Home Comma (,) Divide (/) On Numeric Keypad SysReq Right Alt/Menu Pause Home Up Page Up/Prior Left On Numeric Keypad On UK/Germany Keyboards Right End Down (NEC PC98) (NEC PC98) (NEC PC98) Japanese Keyboard /? on Portugese (Brazil) keyboards Japanese Keyboard Japanese Keyboard Japanese Keyboard Numpad on Portugese (Brazil) keyboards = on numeric key pad (NEC PC98) Previous Track (NEC PC98) (NEC PC98) (NEC PC98) Japanese Keyboard Next Insert Delete Left Windows Right Windows Apps Power Sleep Wake Web Search Web Favorites Web Refresh Web Stop Web Forward Web Back My Computer Mail Media Select SCANCODE 149 150 151 153 156 157 160 161 162 164 174 176 178 179 181 183 184 197 199 200 201 203 205 207 208 209 210 211 219 220 221 222 223 227 229 230 231 232 233 234 235 236 237 COMENTARIOS (NEC PC98) Japan AX (J3100) Next Track ENTER on Numeric Keypad Mute Calculator Play/Pause Media Stop Volume Volume + Web Home On Numeric Keypad(NEX PC98) On Numeric Keypad Right Alt Pause Home on Arrow Pad Up Arrow on Arrow Keypad Page Up on Arrow Keypad Left Arrow on Arrow Keypad Right Arrow on Arrow Keypad End Key on Arrow Keypad Down Key on Arrow Keypad Next Key on Arrow Keypad Insert Key on Arrow Keypad Delete Key on Arrow Keypad Left Windows Key Right Windows Key Apps Menu Key System Power System Sleep System Wake

On Main Keyboard Backspace key

On Numeric Keypad

Return/Enter on Main Keyboard

Igual On Main keyboard On Main Keyboard On Numeric Keypad PrevTrack AT Dos puntos (:) Underline Kanji

141 144 145 146 147 148

Descripcin del Comando:

En una estructura condicional IF ... THEN, puedes querer comprobar otra condicin si la original falla. Mira el ejemplo.

Este comando te permite crear una estructura que, dependiendo del valor de la variable suministrada, ejecutar un grupo de comandos en concreto en diferentes casos (CASE). Puedes tambin especificar un caso DEFAULT por si NINGUNO de los casos anteriores se dio. El final de esta estructura se marca con el comando END SELECT. Elegir esta estructura elimina la necesidad de usar enormes condiciones IF/THEN anidadas. Mira el ejemplo para ms informacin.

Este comando termina la estructura SELECT. Mira SELECT, CASE, y DEFAULT para ms informacin.

El operador NOT se usa para determinar si una condicin es FALSE en vez de TRUE. Se usa frecuentemente en bucles WHILE y estructuras IF para comprobar la NO-EXISTENCIA de un evento o valor. Usamos NOT frecuentemente en nuestros ejemplos, dentro de bucles WHILE para saber si la tecla ESC ha sido presionada.

Remplaza el comando UNTIL en un bucle REPEAT ... UNTIL para crear un bucle infinito. Recuerda, la ejecucin del programa continuar indefinidamente hasta que salgas del bucle por medio del cdigo. Es normalmente conocido como un 'bucle infinito'. Usa EXIT (para marcharte del bucle) o END para acabar el programa.

El primer comando de un bucle FOR ... NEXT, este comando se usa para asignar a una variable una serie de nmeros para ejecutar un bloque de cdigo un nmero de veces. Usando el comando STEP podrs saltar un valor en concreto entre cada ciclo del bucle. Mira el ejemplo. Nota: Al contrario que en muchos lenguajes BASIC, el comando NEXT NO usa la variable del comando FOR como un identificador.

Este comando cierra un bucle FOR ... NEXT, causando que la ejecucin del programa vuelva al comando FOR si la condicin no se ha cumplido. Comprueba el ejemplo para ms informacin. Nora: NO uses la variable del comando FOR como un parmetro (p.e. NEXT t) como lo haras en la mayora de los lenguajes BASIC. Blitz automticamente usa la variable del FOR ms cercano.

Ejemplo:
; Imprime For t = 1 Print t Next ; Imprime For t = 1 Print t Next nmeros del 10 al 1 To 10

los valores 1,3,5,7,9 To 10 Step 2

Ejemplo:
Print "El programa comienza..." Gosub label1 Print "El programa acaba..."

Ayuda Blitz Basic ; espera que pulses ESC para acabar While Not KeyHit(1) Wend End .label1 Print "Podramos hacer todo lo que quisieramos en esta parte del programa..." Print "Pero volveremos donde fuimos llamados..." Return

.label
Definicin:
Establece una etiqueta a la que se puede llamar en el interior de tu programa.

Descripcin de los Parmetros:

label = un nombre vlido

Descripcin del Comando:

Ejemplo:
; End Function Example ; Get the user's name name$=Input$("Enter Your Name:") ; Call a function to print how many letters the name has numletters(name$); ;The program basically ends here, because functions don't run unless called. ; The actual function Function numletters(passedname$) Print "Your name has " + Len(passedname$) + " letters in it." End Function

Const variablename
Definicin:
Declara una variable como una constante y le asigna un valor.

Descripcin de los Parmetros:

variablename = algn nombre vlido de variable

Descripcin del Comando:

Este comando declara una variable como una constante (una variable cuyo valor no podr ser modificado) y le asigna un valor.

Prepara un array usando el tipo de variable especificado. Puedes usar tantas dimensiones como desees (el lmite est en la memoria de tu ordenador). No hay forma de 'redimensionar' los arrays en Blitz, as que asegrate de definirlos adecuadamente. Usa la notacin correcta en la declaracin de la variable para que sea una cadena de texto ($), nmero real (#) o nmero entero. Nota: Los arrays empiezan siempre con la referencia CERO (as variable(0) es el primer elemento del array). Para usar este comando de forma efectiva, debes entender los arrays. Piensa en un array como en una variable que tiene mltiples bloques con valores distintos todo dentro del mismo nombre de variable. Antes de la llegada de los TYPE's, ste era el mejor mtodo de almacenar elementos repetidos porque puedes alterarlos a travs de un array fcilmente. Por ejemplo, quieres poner 100 aliens en la pantalla. Tendras que usar dos variables (alienx y alieny). Mediante estos arrays (alienx() y alieny(), con 100 elementos cada uno), podras fcilmente establecer la localizacin del primer alien usando alienx(1), alieny(1). Las coordenadas del siguiente alien estaran en alienx(2), alienx(2) y as sucesivamente. Esto se hace fcilmente usando un bucle FOR ... NEXT o EACH pasando por todos los elementos. Los arrays tambin son muy tiles para notaciones 'multidimensionales'. En vez de almacenar las coordenadas de los 100 aliens con el mtodo anterior, puedes usar una nica variable: alien(100,1). El primer elemento indica que en la coleccin hay 100 aliens, el

Ayuda Blitz Basic segundo elemento es la localizacin X e Y de ese alien (el elemento 0 sera la coordenada X y el 1 la coordenada Y). As, para establecer la posicin del alien 57 a X=640, Y=480 se hara esto: alien(57,0)=640 alien(57,1)=480 DrawImage imgAlien,alien(57,0),alien(57,1) De acuerdo, los TYPE's son mucho mejor mtodo para manejar estos mltiples valores con pocas rutinas. Los arrays son muy buenos para alamacenar colecciones de objetos con un elemento comn, pero a veces los TYPE's son ms tiles.

Ejemplo:
; DIM example ; Create a collection of 100 random numbers ; Declare our array Dim nums(100) ; Fill each element with a random number For T = 1 to 100 nums(t) = Rnd(1,100) Next

Type variable
Definicin:
Define un objeto con una coleccin de variables.

Descripcin de los Parmetros:

variable = un nombre de variable vlido

Descripcin del Comando:

Si conoces la programacin en C, un TYPE es bsicamente un STRUCT en Blitz Basic. Si no conoces C, sigue leyendo! TYPE es tu mejor amigo. Se usa para crear una 'coleccin' de objetos que comparten los mismos parmetros y necesitan ser utilizados rpida y fcilmente. Piensa en SPACE INVADERS. Hay muchos aliens en la pantalla a la vez. Cada uno de esos aliens tienen unas variables que todos necesitan: las coordenadas X e Y ms una variable para controlar el grfico que deben mostrar (piernas fuera o piernas dentro). Ahora, podramos crear cientos de variables como invader1x, invader1y, invader2x, invader2y, etc. para controlar todos los aliens, pero eso tendra sentido? Pordras usar un array para almacenarlos; invader(nmero,x,y,grfico), y el bucle FOR ... NEXT para manejarlos pero eso es mucho trabajo! La coleccin de variables TYPE fue creada para manejar precisamente este tipo de necesidades. TYPE define una coleccin de objetos. Cada objeto en la coleccin tiene su propia copia de las variables definidas por el comando TYPE FIELD. Cada variable de cada objeto en la coleccin puede ser leda individualmente y fcilmente modificada. Usa el comando FIELD para asignar las variables que quieras entre los comandos TYPE y END TYPE. Si ayuda, piensa que una coleccin TYPE es una base de datos. Cada objeto es una entrada de la base de datos, y cada variable es un campo de la entrada. Usando comandos como BEFORE, AFTER, y FOR ... EACH, puedes mover el puntero de la 'base de datos' para apuntar a una entrada diferente y recuperar/modificar el valor del campo (variable). No eres un gur de las bases de datos? Necesitas otro ejemplo? Vale. Diremos que ests preparando un auditorio para dar un dscurso o algn evento y est poniendo cientos de sillas para los espectadores. Las sillas tienen un lugar en concreto en el suelo, y algunas necesitars reservarlas para gente importante (dignatarios, el alcalde, etc.). Compruebas el suelo, y te das cuenta de que no es ms que una cuadrcula! Esto ser muy fcil! Slo necesitas numerar cada 'pieza' del suelo en un dibujo en papel y poner en la cuadrcula el 'nivel de importancia' de la persona que se sentar en ella. As, tendrs para cada silla una fila y una columna en el dibujo que has hecho en papel (posicion X e Y) y un nivel al que ajustarla ('importancia' o 'altura'). Bien, ya estamos organizados. Ahora, aunque todo lo que tenemos est en papel, todava tenemos que realizar el trabajo de colocar los asientos. Despus de que est todo hecho, diremos que tus jefes van hacia ti y te dicen 'No estn centrados a la derecha... muvelos todos un asiento'. No pasa nada! Tienes todo controlado, ya que es tan simple como mover todo una silla a la derecha (despus de todo, si orden y 'altura' no cambiarn) - todava tienes que mover cada silla! En Blitz, podras tener un TYPE llamado SILLA, establecer los FIELD'S del TYPE como X, Y, y ALTURA. Puedes crear tantas sillas como necesites con el comando NEW (cada vez que usas NEW, crea una nueva silla, con sus PROPIAS variables X, Y y ALTURA) y las asigna la X, Y y ALTURA que creas conveniente. En el ejemplo siguiente, cuando el jefe te diga que debes mover las sillas una posicin, probablemente te quejes. Eso es mucho trabajo! En Blitz, podramos usar cuatro lneas de cdigo para ajustar todos nuestros objetos SILLA a su nueva posicin (mediante comandos FOR ... EACH). Todava perdido? Est bien - los TYPE's son difciles de entender. Mira el ejemplo e intentaremos mostrarte como trabajan los TYPE's en un entorno prctico. Te recomiendo mirar el cdigo de otra gente tambin, para ayudarte a obtener un buen manejo de ellos. Una vez lo hagas, sabrs por qu la gente que programa en C est loca por los STRUCTs y por qu se usan tanto los TYPE's en Blitz.

type_variable = el actual nombre Type

Descripcin del Comando:

Si no ests familiarizado con el comando TYPE, por favor, chale un vistazo antes de continuar leyendo acerca de este comando. Crea un NUEVO objeto en una coleccin Type. Cada llamada a este comando automticamente inserta un nuevo objeto en la coleccin Type especificada. Comprueba el ejemplo y otros comandos Type para ms informacin.

Si no has ledo el comando TYPE, hazlo si quieres hacer algo antes de continuar. salo para asignar un objeto Type personalizado al anterior objeto de la coleccin. Mira el ejemplo.

TRUE es una palabra clave que indica un resultado positivo en una condicin. A menudo, TRUE est implicado y no necesita ser referenciado directamente. TRUE puede usarse tambin como un valor RETURN de una FUNCIN. Mira el ejemplo.

Ejemplo:
; Ejemplo TRUE ; Asigna a test un nmero aleatorio (1 o 0) test= Rnd(0,1) ; TRUE est implicado; Esta lnea significa REALLMENTE: si test es igual a 1 de verdad (TRUE) entonces continua If test=1 Then Print "Test es igual a 1" End If ; Establezcamos test a TRUE

Ayuda Blitz Basic test=True If test=True Then Print "Test es true" End If

False
Definicin:
Una expresin booleana usada en las comparaciones. Actualmente devuelve un valor de 0.

Descripcin de los Parmetros:

Ninguno.

Descripcin del Comando:

FALSE es una palabra clave que denota un resultado negativo en una condicin. Muchas veces, FALSE est implicado y no necesita hacerle referencia (se puede usar el comando NOT en la comparacin). FALSE puede tambin ser usado como un valor RETURN desde una FUNCTION. Mira tambin el comando TRUE. Mira el ejemplo.

Ejemplo:
; Ejemplo FALSE ; Asigna a test un numero aleatorio de 1 o 0 test= Rnd(0,1) ; FALSE esta implicado porque esta el NOT If not test=1 Then Print "Test es igual a 0" End If ; Establezcamos a 'tst' como FALSE test=False If test=False Then Print "Test es FALSE" else print "Test es TRUE" End If

Null
Definicin:
Indica un valor nulo o vaco.

Descripcin de los Parmetros:

Ninguno.

Descripcin del Comando:

Designa un valor nulo. til para borrar una variable o para probar si una variable tiene algn valor.

Ejemplo:
; Ejemplo Null strHello$="Hola Mundo" Print strHello$ strHello$=Null

Data list_of_values
Definicin:
Crea una lista de valores constantes para ser usados en tu programa.

Ayuda Blitz Basic

Descripcin de los Parmetros:

list_of_values = una lista de los valores separados por comas (las cadenas de texto deben ir entre comillas)

Descripcin del Comando:

Descripcin del Comando:

Devuelve seis dgitos del valor de Pi (3.141592), necesario para rutinas geomtricas.

Ejemplo:

22 ; Ejemplo Pi Print "El valor de Pi es: " + Pi

Ayuda Blitz Basic

Int (value)
Parmetros:
value - algn valor o variable vlida

Descripcin:
Este valor redondea al nmero entero ms cercano y lo devuelve.

Ejemplo:
; Int Example ; ----------Print Int(0.25) ; = 0 Print Int(0.5) ; = 0 Print Int(0.75) ; = 1

Float variable/value
Definicin:
Convierte un valor entero en uno de coma flotante (real).

Descripcin de los Parmetros:

variable/value = valor entero o variable

Descripcin del Comando:

Usa este comando para transformar un valor entero en uno de coma flotante.

Ejemplo:
; Float example a=100 b#=2.5 c#=Float a Print b# + c#

Floor# (float)
Definicin:
Redondea una variable decimal a la baja.

Descripcin de los Parmetros:

float=nmero de coma flotante

Descripcin del Comando:

Muchas veces necesitars redondear a la alta o a la baja un nmero decimal. Este comando los redondea a la baja. Usa Ceil# para redondear a la alta.

Usa este comando para devolver el valor absoluto de un nmero, es decir, su valor positivo. Un -3 se convertira en un 3. Si lo que quieres es un nmero sin decimales (p. e. convertir 3.1415 en 3) usa el comando Int().

Este comando se usa para trasladar valores de ngulos a coordenadas, pero hay algunas cosas que deberas tener en cuenta cuando lo uses. Lo primero de todo el comando Sin() asume el punto que quieres es de radio 1 (pixel), despus usa un crculo donde 0 grados es el punto ms al ESTE e incrementa en el sentido contrario de las agujas del reloj, entonces tienes que tener en cuenta que el eje Y en una pantalla de ordenador es arriba-a-abajo comparado con un sistema de coordenadas matemtico normal. Mira tambin ASin, Cos, ACos, Tan, Atan, ATan2

Este comando se usa para trasladar los valores de las coordenadas X/Y a ngulos. Recuerda que la pantalla del ordenador usa un eje Y invertido (los valores son mayores cuanto ms abajo estn).

Ayuda Blitz Basic

Ejemplo:
Graphics 640,480 Repeat Cls ; Determina las posiciones y la longitud de la hipotenusa x# = MouseX() ; desplazamientto horizontal por la pantalla y# = MouseY() ; desplazamientto vertical por la pantalla r# = Sqr((x#*x#)+(y#*y#)) ; longitud de la hipotenusa ; Dibuja los ejes Color 104,104,104 Line x#,0,x#,y# ; dibuja una linea perpendicular al cursor desde la parte superior de la pantalla Line 0,y#,x#,y# ; dibuja una linea perpendicular al cursor desde la parte izquierda de la pantalla Locate x#+10,y#-10 : Write "X=" : Print x# Locate x#-10,y#+10 : Write "Y=" :Print y# Origin 0,0 ; dibuja la lnea del ngulo Color 255,255,255 Line 0,0,x#,y# ; dibuja una linea desde la esquina superior izquierda hasta el cursor theta# = ASin(y#/r#) ; el angulo entre el eje x y el eje y Locate 60,10 : Write "ngulo:" : Print theta ; Dibuja un arco representando el ngulo For degrees#=0 To theta#; pasa a travs de todos los grados en el ngulo ; La siguiente linea calcula las coordenadas X e Y del punto del circulo usando los comandos Sin y Cos ; y multiplicandolo por 5 el resultado (para obtener un radio mayor) cy=Sin(degrees#)*50 cx=Cos(degrees#)*50 Plot cx,cy ; Dibuja el punto actual del crculo. Next Flip ; Pulsa ESC para salir Until KeyDown(1) End

ACos (nmero)
Definicin:
Devuelve el arcocoseno del argumento especificado.

Descripcin de los Parmetros:

nmero = flotante o entero representando un radio de la coordenada "X" al desplazamiento tagencial.

Descripcin del Comando:

Este comando se usa para trasladar las coordenadas X/Y a ngulos. Recuerda que la pantalla del ordenador usa un eje Y invertido (los valores son mayores cuanto ms abajo est).

Ejemplo:
Ver Ejemplo Asin

ATan (flotante)
Definicin:
Devuelve el ngulo desde el eje X hasta un punto (y,x).

Descripcin de los Parmetros:

Ninguno.

Descripcin del Comando:

Se usa a menudo para encriptaciones ligeras (mejor dicho insignificantes ;), coger dos valores y realizar un OR exclusivo con cada bit siguiendo las reglas bsicas del XOR. Las reglas bsicas del Xor son: 0 Xor 0 = 0 1 Xor 0 = 1 0 Xor 1 = 1 1 Xor 1 = 0 Es decir, slo se debe cumplir UNA de las condiciones. Mira el ejemplo para ms informacin.

Ejemplo:
num=%11110000111100001111000011110000 ; Define un patrn de bits fcil de reconocer bitmask=Rnd(-2147483648,2147483647) ; Define un patrn aleatorio de 32bit con el que realizar la comparacin (lo llamaremos 'bitmask') ; Esta lnea imprime los valores binario y decimal antes de realizar el Xor Print "El Nmero binario es: "+Bin$(num)+" ("+num+")" ; Esta lnea imprime los valores binario y decimal del bitmask antes de realizar el Xor Print "El bitmask del Xor es: "+Bin$(bitmask)+" ("+bitmask+")" Print "------------------------------------------------------------------" ; Esta lnea realiza la comparacin xor del nmero con el bitmask xres=num Xor bitmask ; Esta lnea imprime el valor en binario y decimal despus del Xor Print "El resultado del Xor es: "+Bin$(xres)+" ("+xres+")" Print "------------------------------------------------------------------" ; Esta lnea realiza un Xor con el resultado anterior y el bitmask otra vez xres=xres Xor bitmask ; Esta lnea imprime el valor en binario y decimal despus del segundo Xor. NOTA: Este nmero es idntico al nmero original. Print "Resultado del segundo Xor es: "+Bin$(xres)+" ("+xres+")" WaitMouse ; Espera a que pulses un botn del ratn antes de acabar

Shl repetitions
Definicin:
Realiza un desplazamiento binario a la izquierda.

Descripcin de los Parmetros:

repetitions = n de desplazamientos a realizar

Descripcin del Comando:

Realiza un desplazamiento binario a la izquierda en el valor el nmero especificado de veces. Esto bsicamente es un mtodo rpido de multiplicar un valor exponencialmente. Desplazando una vez a la derecha, ests multiplicando por 2 el valor. Desplazando dos veces, multiplicas por 4, etc.

Ejemplo:
; Ejemplos shl, shr, sar value = 100 ; multiplica Print "Mover ; multiplica Print "Mover ; multiplica Print "Mover por 2 1 bit a la izquierda; Valor = " + value Shl 1 por 4 2 bits a la izquierda; Valor = " + value Shl 2 por 16 4 bits a la izquierda; Valor = " + value Shl 4

30 ; divide entre Print "Mover 1 ; divide entre Print "Mover 2 ; divide entre Print "Mover 4 2 bit a la derecha; Valor = " + value Shr 1 4 bits a la derecha; Valor = " + value Shr 2 entre 16 bits a la derecha; Valor = " + value Shr 4

Ayuda Blitz Basic

Ejemplo:
y=Rnd(0,10) ; Establece a Y a un entero aleatorio entre 0 y 10 y#=Rnd(0,5) ; Establece a Y un valor de coma flotante entre 0.000000 y 10.000000

Rand ([low value],high value)

Definicin:
Genera un entero aleatorio entre los valores especificados.

Ayuda Blitz Basic

Descripcin de los Parmetros:

low value = opcional - por defecto 1; valor ms bajo high value = valor ms alto

Descripcin del Comando:

Al contrario que el comando RND, este comando actualmente devuelve slo valores enteros. El valor ms bajo es por defecto 1 si no se especifica ninguno. El valor ms alto es el lmite del nmero generado. Si necesitas generar nmeros flotantes, usa Rnd.

Ejemplo:
; Ejemplo Rand ; Establece la semilla de numeros aleatorios para que sean nuevos SeedRnd (MilliSecs()) ; Genera nmeros aleatorios entre 1 y 100 For t = 1 To 20 Print Rand(1,100) Next

SeedRnd seed
Definicin:
Establece el conjunto de nmeros aleatorios para el generador con un valor 'semilla'.

Descripcin de los Parmetros:

seed = valor entero

Descripcin del Comando:

Los generadores de nmeros aleatorios en los ordenadores no son realmente aleatorios. Generan nmeros basados en un valor 'semilla' (un nmero entero). Si no cambias esta 'semilla', siempre devolver la misma serie de nmeros. Usa este comando para asegurarte de que los nmeros que obtienes son siempre distintos. Normalmente establecers el valor 'semilla' al reloj del sistema para segurarte de que es distinto en cada ejecucin. Mira el ejemplo para comprobar el uso ms corriente de este comando.

Ejemplo:
SeedRnd Millisecs() ; Cambia la semilla con el tiempo de sistema actual en milsimas de segundo.

CADENAS Str variable/value

Definicin:
Convierte un valor numrico en una cadena de texto.

Descripcin de los Parmetros:

variable/value = valor o variable numrica

Descripcin del Comando:

Usa este comando para transformar un valor numrico en una cadena de texto . Blitz imprime valores numricos sin problemas, pero podras querer usar funciones como LEFT$, que slo funcionan en cadenas de texto.

Ejemplo:
; Ejemplo STR num#=2.5 mynum$=str num# Print mynum$

Left$ (string$, length)

Definicin:
Devuelve un cierto nmero de letras de una cadena de texto, empezando a contar por la izquierda.

Ejemplo:
name$="Sergio Padrino" Print "Nueva cadena de texto: '" + RSet$(name$,40) + "'"

Chr$ (integer)
Definicin:
Convierte un cdigo ASCII en su correspondiente carcter.

Descripcin de los Parmetros:

integer = cdigo ASCII vlido

Descripcin del Comando:

Usa este comando para convertir un cdigo ASCII conocido (por ejemplo 65) en su carcter equivalente (en este caso la letra 'A').

Convierte valores enteros en valores binarios. Si no sabes lo que es binario, no necesitas conocer este comando :)

Ejemplo:
intValue="64738" Print "El valor binario de "+intValue+" es: " + bin$(intValue)

Ayuda Blitz Basic

String$ (string$, integer)

Definicin:
Devuelve una cadena de texto un nmero de veces en concreto.

Descripcin de los Parmetros:

string$ = cadena de texto integer = nmero de veces a repetir el texto

Descripcin del Comando:

Este comando crea una cadena de texto compuesta por el texto especificado repetido un nmero de veces en concreto. En otras palabras, puedes usar este comando para escribir una misma cadena de texto una y otra vez. Mira el ejemplo.

Ejemplo:
name$="Sergio" ' Escribe el nombre 10 veces Print String$(name$,10)

TEXTO Print [string$]

Parameter:
string$ (opcional) - cadena de texto o valor

Descripcin:
Escribe una cadena de texto en el front buffer y comienza una nueva lnea. Si el parmetro opcional string es omitido, entonces el comando comenzar una nueva lnea. Mira tambin: Write.

Ejemplo:
; Ejemplo Print ; ------------Print "Blitz " Print "Basic"

Write string$
Parameter:
string$ - cadena de texto o valor numrico

Descripcin:
Escribe una cadena de texto en el front buffer (es decir, la pantalla), pero no cambia de lnea (al contrario que Print). Mira tambin: Print.

Ejemplo:
; Ejemplo Write ; ------------Write "Blitz " Write "Basic"

Locate x,y
Definicin:
Posiciona los comandos de texto en la pantalla.

Descripcin de los Parmetros:

x=coordenada x de la pantalla y=coordenada y de la pantalla

Ayuda Blitz Basic

Descripcin del Comando:

Algunas veces quieres usar los comandos PRINT e Input$ en una posicin especfica de la pantalla. Este comando posiciona el 'cursor' en la localizacin especificada.

Ejemplo:
; Ejemplo Locate strName$=Input$("Cmo te llamas?") Locate 100,200 Print "Hola, " + strName$ While Not KeyHit(1) Wend

Text x,y,string$,[center x],[center y]

Definicin:
Escribe texto en la pantalla en las coordenadas especificadas.

Descripcin de los Parmetros:

x = coordenada x para comenzar a escribir y = coordenada y para comenzar a escribir string$ = texto a escribir center x = opcional; true = centra horizontalmente center y = opcional; true = center verticalmente

Descripcin del Comando:

Imprime un texto en las coordenadas de la pantalla especificadas. Puedes centrar el texto en las coordenadas estableciendo center x/center y en TRUE. El texto se dibujar en el color actual de dibujo. Nota: Imprimiendo un espacio con texto NO se dibujar un bloque - un espacio es un valor vaco. As imprimiendo " " no aparecer una caja.

Ejemplo:
; Ejemplo Text ; Activo el modo grfico Graphics 800,600,16 ; Espera que pulses la tecla ESC antes de acabar While Not KeyHit(1) ;Imprime el texto, centrado horizontalmente en las coordenadas x=400, y=0 Text 400,0,"!Hola Mundo!",True,False Wend

LoadFont (fontname$,height,bold,italic,underlined)
Parmetros:
fontname$ - nombre de la fuente a cargar, p.e. "arial" height - altura en pixels de la fuente bold - True para cargarla en negrita, False en caso contrario italic - True para cargarla en cursiva, False en caso contrario underlined - True para cargarla subrayada, False en caso contrario

Descripcin:
Carga una fuente y devuelve su handle. Puedes entonces usar el handle con comandos como SetFont y FreeFont. Nota: Blitz no trabaja con fuentes de SMBOLOS, como Webdings y WingDings.

Ejemplo:
; Ejemplo LoadFont/SetFont/FreeFont ; ---------------------------------

38 ; Activa el modo Grfico Graphics 800,600,16 ; Crea las variables globales para las fuentes Global fntArial,fntArialB,fntArialI,fntArialU ; Carga las fuentes fntArial=LoadFont("Arial",24,False,False,False) fntArialB=LoadFont("Arial",18,True,False,False) fntArialI=LoadFont("Arial",32,False,True,False) fntArialU=LoadFont("Arial",14,False,False,True) ; Establece la fuente e imprime el texto SetFont fntArial Text 400,0,"Esta es la Arial 24 puntos",True,False SetFont fntArialB Text 400,30,"Esta es la Arial 18 puntos negrita",True,False SetFont fntArialI Text 400,60,"Esta es la Arial 32 puntos cursiva",True,False SetFont fntArialU Text 400,90,"Esta es la Arial 14 puntos subrayada",True,False ; Espera a que el usuario pulse ESC para salir While Not KeyHit(1) Wend ; Borra FreeFont FreeFont FreeFont FreeFont todas las fuentes de la memoria! fntArial fntArialB fntArialI fntArialU

Ayuda Blitz Basic

SetFont fonthandle
Definicin:
Establece una fuente cargada previamente para operaciones de escritura.

Descripcin de los Parmetros:

fontname = cadena de texto que contiene el nombre de la fuente height = altura de la fuente bold = TRUE para cargarla en NEGRITA italic = TRUE para cargarla en CURSIVA underlined = TRUE para cargarla en SUBRAYADA

Descripcin del Comando:

Activa una fuente TrueType cargada previamente (a travs del comando LoadFont) para futuras operaciones de escritura como Text. Nota: Blitz no trabaja con fuentes de SMBOLOS, como Webdings y WingDings. Asegrate de liberar la memoria usada por la fuente cuando acabes de usarla mediante el comando FreeFont.

Ejemplo:
Ver Ejemplo LoadFont

SetFont fonthandle
Definicin:
Establece una fuente cargada previamente para operaciones de escritura.

Descripcin de los Parmetros:

Ayuda Blitz Basic

Descripcin del Comando:

Este comando 'resetea' o 'vaca' todas las pulsaciones de teclas en cola. Por ejemplo, si tu has pulsado por cualquier razn las teclas 'A', 'D', 'ESPACIO' y 'F', en el momento que tu hagas un Input$ (por ejemplo: variable$=Input$("Nombre: ") ), si no has usado este comando, en la respuesta aparecern las teclas pulsadas, es decir, aparecera en pantalla esto: "Nombre: AD F" y tendras que borrar esa respuesta que no has escrito, y eso si te das cuenta... No puedo explicarlo ms fcilmente que como lo he hecho. Gracias a Xtreme por ayudarme con la traduccin de este comando.

Ejemplo:
; borra todas las pulsaciones en cola FlushKeys

MoveMouse x,y
Definicin:
Mueve el puntero del ratn a las coordenadas especificadas de la pantalla.

Descripcin de los Parmetros:

x = coordenada x de la pantalla y = coordenada y de la pantalla

Descripcin del Comando:

Aunque el ratn no sea visible en la pantalla, la posicin de ste puedes saberla y asociarle un grfico. Sin embargo, hay veces que quieres poner el puntero en una posicin especfica de la pantalla. Usa este comando para mover le ratn a la localizacin especificada.

Al contrario que otros comandos similares (JoyDown y JoyHit), este comando no necesita saber qu botn ests intentando probar. ste mira si se est pulsando algn botn y devuelve su nmero. Si ests pulsando ms de uno a la vez slo devolver uno. Usa este comando junto con Select/Case para una mxima eficiencia.

Este comando devuelve la coordenada Y del ratn en la pantalla. salo junto con el comando DrawImage para crearte tu propio puntero del ratn, o para controlar algo directamente enla pantalla con el ratn. Usa MouseX() para obtener la coordenada X.

Ejemplo:
; Ejemplo LoadAnimImage/MaskImage MouseX()/MouseY()

MouseZ()
Parmetros:
Ninguno.

Descripcin:
MouseZ devuelve la posicin actual de la rueda del ratn. Empieza en 0 cuando comienza el programa. El valor MouseZ disminuye cuando la giras hacia ti y aumenta cuando haces lo contrario.

Ejemplo:
Graphics 640, 480, 0, 2 SetBuffer BackBuffer () Repeat Text 20, 20, "Posicin de la rueda del ratn: " + MouseZ () Until KeyHit (1) End

MouseXSpeed()
Definicin:
Devuelve los cambios en la posicin del ratn desde la ltima vez que llamaste al comando.

Descripcin de los Parmetros:

Ninguno.

Descripcin del Comando:

A menudo querrs saber la diferencia entre donde ESTABA el ratn y donde est AHORA. Puedes usar este comando y MouseYSpeed() para saberlo. En el ejemplo, cuando lo ejecutes, mueve el ratn hasta un lugar y pulsa el botn izquierdo. Esto har la primera llamada. Entonces, mueve el ratn y pulsa el botn derecho para realizar la segunda y saber la diferencia.

Ayuda Blitz Basic

Ejemplo:
; Ejemplo MouseXSpeed()/MouseYSpeed() Graphics 800,600,16 SetBuffer BackBuffer() ; hasta que se pulse un boton del raton... Repeat Cls Rect MouseX(),MouseY(),2,2,1 ; dibujo un pequeo cuadrado donde esta el raton If MouseHit(1) Then startx=MouseXSpeed():starty=MouseYSpeed() ; Cuando el usuario pulsa el boton derecho del raton, graba la diferencia entre la ultima llamada ; y esta llamada a los comandos mousex/yspeed. If MouseHit(2) Then endx=MouseXSpeed():endy=MouseYSpeed() Flip Until endx ; Muestra los resultados Text 0,0,"Cambios en las coordenadas del ratn: " + endx + "," + endy Flip ; Espera que pulses ESC While Not KeyHit(1) Wend

MouseYSpeed()
Definicin:
Devuelve los cambios en la posicin del ratn desde la ltima vez que llamaste al comando.

Descripcin de los Parmetros:

Ninguno.

Descripcin del Comando:

A menudo querrs saber la diferencia entre donde ESTABA el ratn y donde est AHORA. Puedes usar este comando y MouseXSpeed() para saberlo. En el ejemplo, cuando lo ejecutes, mueve el ratn hasta un lugar y pulsa el botn izquierdo. Esto har la primera llamada. Entonces, mueve el ratn y pulsa el botn derecho para realizar la segunda y saber la diferencia.

Ejemplo:
Ver Ejemplo MouseXSpeed

MouseZ()
Parmetros:
Ninguno.

Descripcin:
MouseZ devuelve la posicin actual de la rueda del ratn. Empieza en 0 cuando comienza el programa. El valor MouseZ disminuye cuando la giras hacia ti y aumenta cuando haces lo contrario.

Descripcin del Comando:

Este comando devuelve el valor del eje Y del joystick. El rango est entre -1 y 1 (todo arriba y todo abajo). El valor devuelto es un nmero de coma flotante (real). Mira el ejemplo.

Ejemplo:
Ver Ejemplo JoyX

Ayuda Blitz Basic

JoyZ ([port])
Definicin:
Devuelve la coordenada del eje Z del joystick.

Descripcin de los Parmetros:

port = puerto del joystick a comprobar (opcional)

Descripcin del Comando:

Este comando devuelve el valor del eje Z del joystick.El rango est entre -1 y 1.El valor devuelto es un nmero de coma flotante (real).Mira el ejemplo.

Ejemplo:
; Ejemplo JoyZ() While Not KeyHit(1) Cls Text 0,0,"Valor Joy Z: " + JoyZ() Wend

JoyXDir ([port])
Definicin: Devuelve la direccin del eje X del joystick. Descripcin de los Parmetros: port = puerto del joystick a comprobar (opcional) Descripcin del Comando:
Este comando devuelve la direccin del eje X del joystick. El calor -1 (izquierda) o 1 (derecha). El valor devuelto es un nmero entero. Mira el ejemplo. Perfecto para joysticks digitales. Como en cualquier comando de joystick, DEBES tener un joystick compatible DirectX y configurado correctamente en Windows para trabajar con l. Mira la documentacin de tu joystick para ms informacin.

Ejemplo:
; Ejemplo JoyXDir() While Not KeyHit(1) Cls Text 0,0,"Direccin X del Joystick: " + JoyXDir() Wend

Hay muchas veces que no ests interesado en las docenas de posibles botones del joystick presionados antes de comprobar una combinacin de botones en particular. O quizs quieres parar el juego y esperar a que algn botn del joystick sea presionado, pero no quieres que un botn "en cola" interrumpa esta pausa. Usa este comando cuando quieras obtener una pulsacin de un botn del joystick. Gracias a Xtreme por ayudarme con la traduccin de este comando.

Ejemplo:
; Ejemplo FlushJoy FlushJoy Print "Pulsa un botn del ratn para salir!" WaitJoy() End

BANCO CreateBank (size)

Parameter:
size - tamao del banco de memoria en bytes

Descripcin:
Crea un banco de memoria y devuelve su handle. Los comandos de bancos te permiten realizar operaciones de datos rpidamente en un bloque de memoria. Esto es til para programar tus propias rutinas de compresin/descompresin, pasando y recibiendo datos de una DLL, p. e. Los tipos de datos disponibles para usar con un banco son: Byte - coge un byte. Los valores estn entre 0 y 255. Short - coge 2 bytes. Los valores estn entre 0 y 65535. Int - coge 4 bytes. Los valores estn entre -2147483647 y 2147483647. Float - coge 4 bytes. Los valores estn entre -3.4x10??? y 3.4x10??

Ayuda Blitz Basic

Ejemplo:
; Ejemplo de Comandos de Banco ; --------------------bnkTest=CreateBank(12) PokeByte bnkTest,1,Rand(255) PokeShort bnkTest,2,Rand(65535) PokeInt bnkTest,4,Rand(-2147483648,2147483647) PokeFloat bnkTest,8,0.5 Print Print Print Print PeekByte(bnkTest,1) PeekShort(bnkTest,2) PeekInt(bnkTest,4) PeekFloat(bnkTest,8)

FreeBank bnkTest

FreeBank bank
Parameter:
bank - handle del banco

Descripcin:
Libera un banco de memoria.

Ejemplo:
; Ejemplo de Comandos de Banco

BankSize (handle_de_banco) Definicin: Devuelve el tamao de un banco. Descripcin de los Parmetros: handle_de_banco = handle asignado al banco cuando es creado. Descripcin del Comando: Usa este comando para determinar el tamao de un banco existente. Mira CreateBank, ResizeBank, y CopyBank. Ejemplo: ; Ejemplo BankSize, ResizeBank, CopyBank ; crea un banco bnkTest=CreateBank(5000) ; lo rellena con enteros aleatorios For t = 0 To 4999 PokeByte bnkTest,t,Rand(9) Next ; Redimensiona el banco ResizeBank bnkTest,10000 ; Copia la primera mitad del banco en la segunda mitad CopyBank bnkTest,0,bnkTest,5000,5000 ; Imprime el tamao final del banco Print BankSize(bnkTest)

Ayuda Blitz Basic

ResizeBank bankhandle,new_size
Definicin:
Redimensiona un banco.

Descripcin de los Parmetros:

bankhandle = handle del banco new_size = nuevo tamao del banco en bytes

Descripcin del Comando:

Redimensiona un banco de memoria creado previamente. Los datos existentes en el banco no sern modificados, pero pueden ser movidos. Mira tambin CreateBank, CopyBank y BankSize.

Ejemplo:
; Ejemplo BankSize, ResizeBank, CopyBank

CopyBank src_bank,src_offset,dest_bank,dest_offset,count
Definicin:
Copia los datos de un banco a otro.

Descripcin de los Parmetros:

src_bank = handle del banco de memoria de origen src_offset = localizacin offset desde donde se comenzar a copiar dest_bank = handle del banco de memoria de destino dest_offset = localizacin offset desde donde se comenzar a escribir count = cuntos bytes se copiarn

Descripcin del Comando:

Copia los datos desde un banco de memoria hasta otro. Si se copia se produce entre bancos iguales, los handles superpondrn sus rangos de memoria.

Ejemplo:
; Ejemplo BankSize, ResizeBank, CopyBank

PeekByte(bank,offset) Parmetros: bank - handle del banco

offset - offset en bytes, en que se comenzar

Descripcin:
Lee un byte de un banco de memoria y devuelve el valor. Los valores pueden ser del rango 0 a 255. Mira tambin: PeekShort, PeekInt, PeekFloat.

Ejemplo:
Ver Ejemplo de Comandos de Banco

PeekShort(bank,offset)
Parmetros:
bank - handle del banco offset - offset en bytes, en que se comenzar

Descripcin:
Lee un short de un banco de memoria y devuelve el valor. Un short coge 2 bytes de un banco de memoria. Los valores pueden estar en el rango 0 a 65535. Mira tambin: PeekByte, PeekInt, PeekFloat.

Ejemplo:
; Ejemplo de Comandos de Banco

Ayuda Blitz Basic

PeekInt(bank,offset)
Parmetros:
bank - handle del banco offset - offset en bytes, en que se comenzar

Descripcin:
Lee un entero de un banco de memoria y devuelve el valor. Un entero coge 4 bytes del banco de memoria. Los valores pueden estar en el rango -2147483647 a 2147483647. Mira tambin: PeekByte, PeekShort, PeekFloat.

Ejemplo:
Ver Ejemplo de Comandos de Banco

PeekFloat(bank,offset)
Parmetros: bank - handle del banco offset - offset en bytes, en que se comenzar Descripcin:
Lee un flotante de un banco de memoria y devuelve su valor. Un flotante coge 4 bytes de un banco de memoria. Los valores pueden estar en el rango -3.4x10??? a 3.4x10??. Mira tambin: PeekByte, PeekShort, PeekInt.

Ejemplo:
Ver Ejemplo de Comandos de Banco

PokeByte bank,offset,value
Parmetros:
bank - handle del banco offset - offset en bytes, desde donde se comenzar a escribir value - valor que ser escrito en el banco

Descripcin:
Escribe un byte en un banco de memoria. Los valores pueden estar en el rango 0 a 255. Mira tambin: PokeShort, PokeInt, PokeFloat.

Ejemplo:
Ver Ejemplo de Comandos de Banco

PokeShort bank,offset,value
Parmetros:
bank - handle del banco offset - offset en bytes, desde donde se comenzar a escribir value - valor que ser escrito en el banco

Descripcin:
Escribe un short en un banco de memoria. Un short coge 2 bytes de un banco de memoria. Los valores pueden estar en el rango 0 a 65535. Mira tambin: PokeByte, PokeInt, PokeFloat.

Ejemplo:
Ver Ejemplo de Comandos de Banco

PokeInt bank,offset,value
Parmetros:
bank - handle del banco offset - offset en bytes, desde donde se comenzar a escribir value - valor que ser escrito en el banco

Descripcin:
Escribe un entero en un banco de memoria. Un entero coge 4 bytes de un banco de memoria. Los valores estn en el rango -2147483647 a 2147483647. Mira tambin: PokeByte, PokeShort, PokeFloat.

Ayuda Blitz Basic

Ejemplo:
Ver Ejemplo de Comandos de Banco

PokeFloat bank,offset,value
Parmetros:
bank - handle del banco offset - offset en bytes, desde donde se comenzar a escribir value - valor que ser escrito en el banco

Descripcin:
Escribe un flotante en un banco de memoria. Un flotante coge 4 bytes. Los valores pueden estar en el rango -3.4x10??? a 3.4x10??. Mira tambin: PokeByte, PokeShort, PokeInt.

filehandle = la variable devuelta por el comando Readfile WriteFile o OpenFile cuando el archivo fue abierto. El valor devuelto es el offset desde el inicio del archivo. ( 0 = Inicio del archivo )

Ayuda Blitz Basic

Descripcin del Comando:

Este comando devuelve la posicin actual dentro de un archivo que es procesado. El entero devuelto es el offset en bytes desde el inicio del archivo hasta la posicin actual de lectura/escritura. Nota, ste es 0 cuando apunta al primer byte del archivo. Usando FilePos y SeekFile la posicin dentro del archivo puede ser determinada y cambiada. Esto permite a un archivo ser ledo y actualizado sin tener que hacer una nueva copia del archivo. Esto sera til si has creado una base de datos y quieres encontrar y actualizar algunas entradas. Es posible crear un archivo de ndice que contenga punteros donde comienza cada entrada en en la base de datos.

Ejemplo:
Ver Ejemplo OpenFile

SeekFile (filehandle, offset)

Definicin:
Mueve el puntero actual dentro de un archivo abierto a una nueva posicin.

Ejemplo:
Ver Ejemplo ReadDir

NextFile$ (filehandle)
Definicin:
Recupera el siguiente archivo/directorio de un directorio abierto con el comando ReadDir.

Descripcin de los Parmetros:

filehandle = handle del archivo asignado con el comando ReadDir

Descripcin del Comando:

Este comando devolverel SIGUIENTE archivo o carpeta del directorio abierto actualmente (usa ReadDir para abrir un directorio y leerlo). ste devolver una cadena de texto que contiene el nombre de la carpeta o archivo ms la extensin. Usa FILETYPE para determinar si es un directorio.

Ejemplo:
Ver Ejemplo ReadDir

CurrentDir$()
Definicin:
Devuelve una cadena de texto que contiene el directorio seleccionado actualmente.

Descripcin de los Parmetros:

Ninguno.

Descripcin del Comando:

Este comando devolver el directorio seleccionado actualmente para realizar operaciones de disco, til para operaciones avanzadas con ficheros. Usa CHANGEDIR para cambiar el directorio actual. El valor devuelto no tendr la barra al final ('\').

from$ = ruta/nombre de archivo vlido del archivo que va a ser copiado to$ = ruta/nombre de archivo donde se va a copiar

Descripcin del Comando:

Usa este comando para copiar un archivo desde una ubicacin hasta otra. Quizs programars tu propio instalador y necesitars copiar archivos desde el directorio de instalacin al directorio donde se instalar el programa. Asegrate de que los archivos que sern copiados existen antes de ejecutar este comando.

Ejemplo:
file$="c:\autoexec.bat" destination$="a:\autoexec.bat" Print "Pulsa una tecla para copiar tu Autoexec.bat en un diskette" WaitKey() CopyFile file$,destination$

DeleteFile path/filename
Definicin:
Borra el archivo especificado.

Ayuda Blitz Basic

Descripcin de los Parmetros:

path/filename = ruta completa\nombre del archivo que se va a borrar

Descripcin del Comando:

Elimina el archivo especificado de la unidad. Necesitars saber si el archivo existe antes de ejecutar este comando y asegurarte de que ha sido borrado DESPUS de su ejecucin. Usa FILETYPE para saberlo.

Ejemplo:
; DELETEFILE example DeleteFile "C:\test\myfile.bb"

ExecFile (filename$)
Definicin:
Ejecuta un ejecutable externo desde el interior de un programa Blitz.

Descripcin de los Parmetros:

filename$ = una variable vlida o ruta/nombre_de_archivo del ejecutable

Descripcin del Comando:

Usa este comando para pausar la ejecucin de tu programa y ejecutar uno externo. Nota: Este comando usa ShellExecute para permitirte abrir un archivo (como un .doc o .txt) con su programa asociado por defecto.

filehandle/stream = una variable vlida establecida con OpenFile, ReadFile o OpenTCPStream (v1.52 o superior)

Descripcin del Comando:

Una vez que has abierto un archivo (o flujo) para leerlo, usa este comando para leer un byte. Nota, un byte es un valor entero entre 0 y 255 y que ocupa 8 bits de espacio. Leer ms all del final del archivo no resultar ningn error, pero el valor devuelto ser 0. Los flujos o 'streams' slo pueden ser usados en Blitz Basic v1.52 o superior.

Ejemplo:
; Ejemplo ReadByte y WriteByte ; Inicializa algunas variables

Ayuda Blitz Basic Byte1% = 10 Byte2% = 100 Byte3% = 255 Byte4% = 256 Byte5% = 257 Byte6% = -1 Byte7% = -2 Byte8% = Asc("A") ; Abre un archivo para modificarlo fileout = WriteFile("mydata.dat ") ; Escribe informacion en el archivo WriteByte( fileout, Byte1 ) WriteByte( fileout, Byte2 ) WriteByte( fileout, Byte3 ) WriteByte( fileout, Byte4 ) WriteByte( fileout, Byte5 ) WriteByte( fileout, Byte6 ) WriteByte( fileout, Byte7 ) WriteByte( fileout, Byte8 ) ; Cierra el archivo CloseFile( fileout ) ; Abre el archivo para leerlo filein = ReadFile("mydata.dat") Read1 Read2 Read3 Read4 Read5 Read6 Read7 Read8 = = = = = = = = ReadByte( ReadByte( ReadByte( ReadByte( ReadByte( ReadByte( ReadByte( ReadByte( filein filein filein filein filein filein filein filein ) ) ) ) ) ) ) )

; Cierra el archivo CloseFile( filein ) Print Write Write Write Write Write Write Write Write "Escrito - Ledo" Byte1 + " - " : Print Byte2 + " - " : Print Byte3 + " - " : Print Byte4 + " - " : Print Byte5 + " - " : Print Byte6 + " - " : Print Byte7 + " - " : Print Byte8 + " - " : Print

Read1 Read2 Read3 Read4 Read5 Read6 Read7 Chr$( Read8 )

WaitKey()

ReadShort (filehandle/stream)
Definicin:
Lee un valor entero short (16 bits) de un archivo o flujo abierto y lo devuelve como un valor entero.

Descripcin de los Parmetros:

filehandle/stream = handle del archivo o flujo El valor devuelto es un entero entre 0 y 65535.

Descripcin del Comando:

Una vez has abierto un archivo o flujo para leerlo, usa este comando para leer un valor entero short (16 bit). Nota: cada valor escrito ocupa 2 bytes de espacio. Leer ms all del final del archivo no resultar un error pero el valor que devolver ser igual a 0. Los flujos o 'streams' slo pueden usarse en Blitz Basic v1.52 o superior.

Ayuda Blitz Basic

Ejemplo:
; Ejemplo ReadShort y WriteShort ; Inicializa algunas variables para el ejemplo Int1% = 10 Int2% = 365 Int3% = 32767 Int4% = -32768 fileout = WriteFile("mydata.dat") ; Escribe algo en el WriteShort( fileout, WriteShort( fileout, WriteShort( fileout, WriteShort( fileout, CloseFile( fileout ) filein = ReadFile("mydata.dat") Read1 Read2 Read3 Read4 = = = = ReadShort( ReadShort( ReadShort( ReadShort( filein filein filein filein ) ) ) ) archivo Int1 ) Int2 ) Int3 ) Int4 )

CloseFile( filein ) Print Print Print Print Print "Datos Short Integer Data Ledos Del Archivo - mydata.dat " Read1 Read2 Read3 Read4

ReadLine$ (filehandle/stream)
Definicin:
Lee una lnea de texto de un archivo o flujo abierto.

Descripcin de los Parmetros:

filehandle/stream = handle del archivo o flujo

Ayuda Blitz Basic

Descripcin del Comando:

Una vez has abierto un archivo o flujo para leerlo, usa este comando para leer una lnea de texto de un archivo de texto o flujo. Cada lnea es devuelta como una cadena de texto. Esta funcin puede ser usada para leer archivos de texto plano. Los caracteres son ledos hasta el 'end-of-line' (fin de lnea). Leer ms all del final del archivo no resultar un error, pero la cadena devuelta tendr una longitud de 0 caracteres (""). ReadLine$ devuelve todos los caracteres excepto chr$(13)/chr$(10). Los flujos o 'streams' slo pueden usarse en Blitz Basic v1.52 o superior. Ejemplo: ; Reading and writing a file using ReadLine$ and WriteLine functions ; Initialise some variables for the example String1$ = "Line 1 is short" String2$ = "Line 2 is a longer line but they can be much longer" String3$ = "Line 3 is made up " String4$ = "of two parts joined together." ; Open a file to write to fileout = WriteFile("mydata.txt") ; Write the information to the file WriteLine( fileout, String1 ) WriteLine( fileout, String2 ) WriteLine( fileout, String3 + String4) WriteLine( fileout, "Just to show you don't have to use variables" ) ; Close the file CloseFile( fileout ) ; Open the file to Read filein = ReadFile("mydata.txt") Read1$ Read2$ Read3$ Read4$ = = = = ReadLine( filein ) ReadLine$( filein ) ReadLine$( filein ) ReadLine$( filein )

; Close the file once reading is finished CloseFile( filein ) Print Print Print Print Print Print "Lines of text read from file - mydata.txt " Read1 Read2 Read3 Read4

WaitKey()

ReadBytes bank,file/stream,offset,count
Definicin:
Lee datos de un archivo (o flujo) en un banco de memoria.

Descripcin de los Parmetros:

bank = handle del banco file/stream = handle de un archivo o flujo abierto offset = offset en bytes para empezar a leer count = cuntos bytes se leern a desde el 'offset'

Descripcin del Comando:

Puedes leer el contenido de un archivo (o flujo) en un banco de memoria a travs de este comando. Nota: el handle de archivo debe ser abierto con OpenFile o OpenTCPStream y cerrado con CloseFile o CloseTCPStream tras acabar con las operaciones de lectura. Devuelve cuntos bytes se pudieron leer de un flujo. Los flujos o 'streams' slo pueden usarse en Blitz Basic v1.52 o superior.

Ayuda Blitz Basic

Ejemplo:
; Read/WriteBytes Commands Example ; Create a 50 byte memory bank bnkTest=CreateBank(500) ; Let's fill the bank with crap For t = 1 To 50 PokeByte bnkTest,t,Rnd(255) PokeInt bnkTest,t+1,Rnd(10000) PokeShort bnkTest,t+2,Rnd(10000) PokeFloat bnkTest,t+3,Rnd(-.999,.999) Next ; Open a file to write to fileBank=WriteFile("test.bnk") ; Write the bank to the file WriteBytes bnkTest,fileBank,0,50 ; Close it CloseFile fileBank ; Free the bank FreeBank bnkTest ; Make a new one bnkTest=CreateBank(500) ; Open the file to read from fileBank=OpenFile("test.bnk") ; Write the bank to the file ReadBytes bnkTest,fileBank,0,50 ; Close it CloseFile fileBank ; Write back the results! For t = 1 To 50 Print PeekByte (bnkTest,t) Print PeekInt (bnkTest,t+1) Print PeekShort (bnkTest,t+2) Print PeekFloat (bnkTest,t+3) Next

WriteByte (filehandle/stream, mybyte)

Definicin:
Escribe un byte en un archivo o flujo abierto.

Descripcin de los Parmetros:

filehandle/stream = una variable vlida establecida con OpenFile, WriteFile o OpenTCPStream (v1.52 o superior) mybyte = puede ser un entero o flotante, pero slo si est entre 0 y 255 ser almacenado correctamente.

Descripcin del Comando:

Una vez que has abierto un archivo (o flujo) para modificarlo, usa este comando para escribir un byte. Nota, un byte es un valor entero entre 0 y 255 y que ocupa 8 bits de espacio. Los flujos slo pueden usarse en Blitz Basic v1.52 o superior.

Ejemplo:
Ver Ejemplo ReadByte

WriteShort (filehandle/stream, myinteger)

Definicin:
Escribe un valor entero short (16 bits) en un archivo o flujo abierto.

Descripcin de los Parmetros:

filehandle/stream = a valid variable set with the OpenFile, WriteFile command, or OpenTCPStream (v1.52+) myinteger = valor entero

Ayuda Blitz Basic

Descripcin del Comando:

Una vez has abierto un archivo o flujo para ser modificado, usa este comando para escribir un entero short (16 bit) en l. Nota, cada valor escrito usa 2 bytes. El rango de cada entero est entre 0 y 65535 Los flujos o 'streams' slo pueden usarse en Blitz Basic v1.52 o superior.

Ejemplo:
Ver Read/WriteBytes

NETWORK CountHostIPs( host_name$ )

Parmetros:
host_name$ - nombre del host

Descripcin:
Busca hosts con el nombre especificado y devuelve el nmero de hosts encontrados.

HostIP( host_index )
Parmetros:
host_index - nmero de ndice del host

Descripcin:
Devuelve una direccin IP del host especificado. El parmetro host_index debe estar entre 1...CountHostIPs().

DottedIP$( IP )
Parmetros:
IP - direccin IP (entero)

Descripcin:
Convierte una direccin IP en notacin de internet.

CopyStream src_stream,dest_stream[,buffer_size]
Parmetros:
src_stream - flujo de origen dest_stream - flujo de destino buffer_size (opcional) - tamao del buffer del flujo

Descripcin:
Copia el flujo de origene n el flujo de destino.

Ayuda Blitz Basic

TCP (NETWORK) OpenTCPStream (ip$,port)

Definicin:
Abre un cliente TCP al servidor especificado.

Descripcin de los Parmetros: ip$=direccin del flujo

port=puerto TCP/IP

Descripcin del Comando:

Usa este comando para abrir un flujo TCP/IP al puerto y servidor designado. Si el comando se completa correctamente, devolver el handle del flujo. De lo contrario devolver 0. Puedes usar este comando para multitud de opciones en internet. Obviamente para contactar con un host TCP/IP fuera de tu propia red, debers estar conectado a Internet. La direccin IP puede ser de la forma 1.2.3.4 o "www.dominio.com".

CloseTCPStream streamhandle
Definicin:
Cierra el flujo TCP especificado.

Descripcin de los Parmetros:

streamhandle = handle asignado cuando el flujo fue creado.

Descripcin del Comando:

Una vez has completado el uso de tu flujo TCP/IP, cierra la conexin que abriste con OpenTCPStream con este comando.

Ejemplo:
Ver Ejemplo OpenTCPStream

CreateTCPServer (port)
Definicin:
Crea un servidor TCP en el puerto especificado.

Ayuda Blitz Basic

Descripcin de los Parmetros:

port = puerto a usar cuando se cree el servidor

Descripcin del Comando:

Crea un servidor TCP/IP en el puerto especificado. salo para comunicaciones entre otros clientes y el ordenador local. Mira OpenTCPStream, CloseTCPServer, y CloseTCPStream para ms informacin. Devuelve el handle del servidor TCP/IP si la operacin fue completada o un 0 en caso contrario.

Ejemplo:
; CreateTCPServer, CloseTCPServer, AcceptTCPStream Example ; This code is in two parts, and needs to be run seperately on the same machine ; --- Start first code set --; Create a server and listen for push svrGame=CreateTCPServer(8080) If svrGame<>0 Then Print "Server started successfully." Else Print "Server failed to start." End End If While Not KeyHit(1) strStream=AcceptTCPStream(svrGame) If strStream Then Print ReadString$(strStream) Delay 2000 End Else Print "No word from Apollo X yet ..." Delay 1000 End If Wend End ; --- End first code set ---

; --- Start second code set --; Copy this code to another instance of Blitz Basic ; Run the above code first, then run this ... they will 'talk' ; Create a Client and push data strmGame=OpenTCPStream("127.0.0.1",8080) If strmGame<>0 Then Print "Client Connected successfully." Else Print "Server failed to connect." WaitKey End End If ; write stream to server WriteString strmGame,"Mission Control, this is Apollo X ..." Print "Completed sending message to Mission control..." ; --- End second code set ---

AcceptTCPStream (handle_del_servidor)
Definicin:
Acepta una entrada de flujo TCP/IP.

Ayuda Blitz Basic

Descripcin de los Parmetros:

handle_del_servidor = el handle del servidor es asignado cuando el servidor es creado.

Descripcin del Comando:

Acepta una entrada de flujo TCP/IP y devuelve 1 si esta disponible, 0 si no lo est. Mira CreateTCPServer y CloseTCPServer.

Ejemplo:
Ver CreateTCPServer

CloseTCPServer serverhandle
Definicin:
Cierra un servidor TCP.

Descripcin de los Parmetros:

serverhandle = handle asignado cuando el servidor es creado.

Descripcin del Comando:

Cierra un servidor TCP/IP previamente creado con el comando CreateTCPServer.

Ejemplo:
Ver CreateTCPServer

TCPStreamIP( tcp_stream )
Parmetros:
tcp_stream - handle del flujo TCP

Descripcin:
Devuelve la direccin IP del flujo TCP especificado. La direccin devuelta es siempre la del ordenador cliente.

TCPStreamPort( tcp_stream )
Parmetros:
tcp_stream - handle del flujo TCP

Descripcin:
Devuelve el nmero de puerto del flujo TCP especificado. El nmero de puerto devuelto es siempre el del ordenador cliente.

TCPTimeouts read_millis,accept_millis
Parmetros:
read_millis - valor en milsimas de segundo accept_millis - valor en milsimas de segundo

Descripcin:
read_millis te permite controlar cuntos datos se pueden leer en un flujo TCP antes de causar un error. Por defecto, esta establecido a 10,000 (10 segundos). Esto significa que si tarda en leer los datos ms de 10 segundos, ocurrir un error y el flujo no podr volver a usarse. accept_millis te permite controlar cunto esperar el comando AcceptTCPStream() para una nueva conexin. Por defecto, este valor es 0, as AcceptTCPStream() volver automticamente si no hay una nueva conexin disponible.

UDP (NETWORK) CreateUDPStream( [port] )

Parmetros:
port (opcional) - nmero de puerto

Descripcin:
Crea un flujo UDP en el puerto especificado y devuelve un handle de flujo UDP. Si no se especifica ningn puerto, se utilizar uno que est libre y podrs entonces usar UDPStreamPort() para encontrar el puerto que se est utilizando.

Ayuda Blitz Basic

CloseUDPStream udp_stream
Parmetros:
udp_stream - handle del flujo UDP

Descripcin:
Cierra un flujo UDP.

SendUDPMsg udp_stream,dest_ip[,dest_port]
Parmetros:
udp_stream - handle de un flujo UDP dest_ip - direccin IP de destino dest_port (opcional) - nmero de puerto de destino

Descripcin:
Transmite todos los datos escritos en el flujo UDP a la direccin IP y puerto especificados. La informacin est escrita con los comandos estndar de flujos. Si no se especifica el puerto, se utilizar el que se us para crear el Flujo UDP.

RecvUDPMsg( udp_stream )
Parmetros:
udp_stream - handle del flujo UDP

Descripcin:
Recibe un mensaje UDP del flujo UDP especificado. Comandos de flujos estndar pueden usarse para examinar el mensaje. El valor devuelto es un entero con la direccin IP de origen del mensaje, o 0 si el mensaje no est disponible. Puedes usar UDPMsgPort() para encontrar el nmero de puerto de origen del mensaje.

UDPStreamIP( udp_stream )
Parmetros:
udp_stream - handle del flujo UDP

Descripcin:
Devuelve la direccin IP del flujo UDP especificado. Actualmente, siempre devuelve 0.

UDPStreamPort( udp_stream )
Parmetros:
udp_stream - handle del flujo UDP

Descripcin:
Devuelve el nmero de puerto del flujo UDP especificado. Esto puede ser til si has creado el flujo UDP sin especificar el puerto.

UDPMsgIP( udp_stream )
Parmetros:
udp_stream - handle del flujo UDP

Descripcin:
Devuelve la direccin IP del remitente del ltimo mensaje UDP recibido. Este valor tambin es devuelto por RecvUDPMsg().

UDPMsgPort( udp_stream )
Parmetros:
udp_stream - handle del flujo UDP

Descripcin:
Devuelve el puerto del remitente del ltimo mensaje UDP recibido.

Ayuda Blitz Basic

UDPTimeouts recv_millis
Parmetros:
recv_millis - valor en milsimas de segundo

Descripcin:
recv_millis te permite controlar cuanto puede esperar la funcin RecvUDPMsg() para recibir un nuevo mensaje. Por defecto, est establecido en 0, lo que significa que RecvUDPMsg() retornar inmediatamente si no se ha recibido ningn mensaje.

DIRECTPLAY StartNetGame()
Definicin:
Comienza un juego en red.

Descripcin de los Parmetros:

Ninguno.

Descripcin del Comando:

Muestra un cuadro de dilogo de Windows con opcin de unirse o empezar un nuevo juego multijugador en red, va mdem, conexin serial o TCP/IP (Internet). Nota: este comando debe usarse antes que cualquier otro comando de red, de otra manera los otros comandos fallarn. Un valor de retorno igual a 0 indica que fall, 1 significa que se uni al juego y 2 que se cre un nuevo juego (el host sera el ordenador local).

Ejemplo:
newGame = StartNetGame() ; Check the status of the new game. If newGame = 0 Then print "Could not start or join net game." ElseIf newGame = 1 print "Successfully joined the network game." ElseIf newGame = 2 print "A new network game was started." EndIf

HostNetGame (gamename$)
Definicin:
Crea un juego en red como HOST.

Descripcin de los Parmetros:

gamename$ = valor string (cadena) en el que se asigna el nombre del juego

Descripcin del Comando:

Este se usa para desviar el 'estndard' en juegos en red (normalmente usando StartNetGame) y empezar el juego como host directamente. Si devuelve el valor de 2, significa que el Host empez el juego correctamente.

Ejemplo:
; HostNetGame example joinResults=HostNetGame("ShaneGame") Select joinResults Case 2 Print "Successfully started host game!" Default Print "Game was unable to start!" End Select waitkey()

Ayuda Blitz Basic

JoinNetGame (gamename$,serverIP$)
Definicin:
Se une a un juego en red en curso.

Descripcin de los Parmetros:

gamename$ = nombre del juego a unirse serverIP$ = direccin IP del ordenador host del juego

Descripcin del Comando:

Usa este comando para unirte a un juego en red, evitando el cuadro de dilogo que aparece al usar el comando StartNetGame. Devuelve 0 si el comando falla o 1 si se uni al juego correctamente.

Ejemplo:
; JoinNetGame example ; Note; run the HostNetGame example code on the other computer ; you wish to join with gamename$="ShaneGame" ; Change this to match the other computer's IP! serverIP$="0.0.0.0" ; Make the join attempt joinResults=JoinNetGame(gamename$,serverIP$) Select joinResults Case 1 Print "Joined the game successfully!" Default Print "Joining the game was unsuccessful." End Select WaitKey()

StopNetGame
Definicin:
Para un juego en red en curso.

Descripcin de los Parmetros:

Ninguno.

Descripcin del Comando:

Usa este comando para acabar un juego en red actualmente en curso (empezado con el comando StartNetGame()). Si es posible, el host ser transferido a otro ordenador conectado al juego.

playerID = nmero ID del jugador (se obtiene con el comando NetMsgFrom() )

Descripcin del Comando:

Esto SLO funciona cuando te has unido a un juego en red va StartNetGame o JoinNetGame y has creado un jugador mediante la funcin CreateNetPlayer (debes crear un jugador primero). Usa este comando junto con NetMsgFrom() (para obtener el ID del jugador) para saber el nombre actual del jugador. Este comando devuelve una cadena de texto. Usars NetMsgType(), NetMsgFrom() y NetMsgTo() para obtener otra informacin importante del mensaje y actuar sobre esta. El ejemplo requiere ser ejecutado tambin en un ordenador remoto mientras el ordenador local usa el comando SendNetMsg.

Ejemplo:
; ; ; ; ; ; ; ; NetPlayerName$() example -------------------Run this program on the REMOTE computer to 'watch' the activity of the SendNetMsg example. Run that example on local machine. This program will tell you when a player involved in the game hits a wall ...

Ayuda Blitz Basic ; Let's see who the message was from msgFrom=NetMsgFrom() ; Let's get the message! msgData$=NetMsgData$() ; Print the message Print msgData$ Print "(Message was from:"+ NetPlayerName$(NetMsgFrom()) + ")" End If End If Wend

NetPlayerLocal (playerID)
Definicin:
Determina si el jugador esta en el ordenador local.

Descripcin de los Parmetros:

playerID = ID del jugador (obtenido con el comando NetMsgFrom() )

Descripcin del Comando:

Esto SLO funciona cuando te has unido a un juego en red va StartNetGame o JoinNetGame y has creado un jugador mediante la funcin CreateNetPlayer (debes crear un jugador primero). Usa este comando junto con NetMsgFrom() (para obtener el ID del jugador) para comprobar si el jugador en cuestin est en el ordenador local (o de lo contrario en uno remoto). Usars NetMsgType(), NetMsgFrom() y NetMsgTo() para obtener otra informacin importante del mensaje y actuar sobre esta. El ejemplo requiere ser ejecutado tambin en un ordenador remoto mientras el ordenador local usa el comando SendNetMsg.

Ejemplo:
; ; ; ; ; ; ; ; NetPlayerLocal example -------------------Run this program on the REMOTE computer to 'watch' the activity of the SendNetMsg example. Run that example on local machine. This program will tell you when a player involved in the game hits a wall ...

; We'll use this instead of JoinHostGame - make it easier StartNetGame() ; Create a player - a player must be created to ; receive mesages! playerID=CreateNetPlayer("Shane") ; Loop and get status While Not KeyHit(1) ; Check to see if we've received a message If RecvNetMsg() Then ; if we did, let's figure out what type it is ; we know it will be a user message, though msgType=NetMsgType() ; 1-99 means a user message If msgType>0 And msgType<100 Then ; Let's see who the message was from msgFrom=NetMsgFrom() ; Let's get the message! msgData$=NetMsgData$() ; Print the message Print msgData$

80 if NetPlayerLocal(NetMsgFrom()) then print "(This was sent from a local player)" end if End If End If Wend

Ayuda Blitz Basic

RecvNetMsg()
Definicin: Valores booleanos indican si un mensaje network ha sido recibido. Descripcin de los Parmetros: Ninguno. Descripcin del Comando:
Esto SLO funciona cuando te has unido a un juego en red va StartNetGame o JoinNetGame y has creado un jugador mediante la funcin CreateNetPlayer (debes crear un jugador primero). Devuelve un valor TRUE si el mensaje ue recibido, o FALSE en caso contrarioThis returns a TRUE value if a message was received, FALSE if none has been received. This will typically go inside a function that is constantly being checked for message and decode and handle them. You will use NetMsgType, NetMsgFrom, NetMsgTo, and NetMsgData$ to get the important information from the message and act on it. The example requires that you run it on a remote machine while the local computer runs the example in the SendNetMsg command.

Ejemplo:
; ; ; ; ; ; ; ; RecvNetMsg() example -------------------Run this program on the REMOTE computer to 'watch' the activity of the SendNetMsg example. Run that example on local machine. This program will tell you when a player involved in the game hits a wall ...

Ayuda Blitz Basic

NetMsgType()
Definicin:
Devuelve el tipo de mensaje recibido durante un juego en red.

Descripcin de los Parmetros:

Ninguno.

Descripcin del Comando:

Esto SLO funciona cuando te has unido a un juego en red va StartNetGame o JoinNetGame y has creado un jugador mediante la funcin CreateNetPlayer (debes crear un jugador primero). Debes haber recibido el mensaje otra vez, determinado por el comando RecvNetMsg(). El valor devuelto por este comando denota el mensage; 1-99 indica que es un mensaje de usuario, 100 significa que un nuevo jugador se ha unido al juego, 101 significa que un jugador ha sido eliminado del juego (NetMsgFrom() devuelve el jugador eliminado), 102 que el host original se march del juego y ESTA mquina es el nuevo host. Si recives un 200, significa que un error fatal ha ocurrido y necesitas salir del juego. Usars NetMsgFrom, NetMsgTo, y NetMsgData$ para obtener informacin importante del mensaje y actuar sobre l. El ejemplo requiere ser ejecutado tambin en un ordenador remoto mientras el ordenador local usa el comando SendNetMsg.

Ejemplo:
; ; ; ; ; ; ; ; NetMsgType() example -------------------Run this program on the REMOTE computer to 'watch' the activity of the SendNetMsg example. Run that example on local machine. This program will tell you when a player involved in the game hits a wall ...

NetMsgFrom()
Definicin:
Devuelve el ID del emisor de un mensaje network.

Descripcin de los Parmetros:

Ninguno.

Ayuda Blitz Basic

Descripcin del Comando:

Esto SLO funciona cuando te has unido a un juego en red va StartNetGame o JoinNetGame y has creado un jugador mediante la funcin CreateNetPlayer (debes crear un jugador primero). Debes haber recibido el mensaje otra vez, determinado por el comando RecvNetMsg() - y probablemente el tipo de mensaje sea determinado con NetMsgType(). El valor devuelto por este comando es el nmero ID del emisor del mensaje que le fue asignado cuando fue creado con el comando CreateNetPlayer. salo para realizar acciones sobre el jugador desde el ordenador local. Usars NetMsgType(), NetMsgTo() y NetMsgData$() para obtener otra informacin importante del mensaje y actuar sobre l. El ejemplo requiere ser ejecutado tambin en un ordenador remoto mientras el ordenador local usa el comando SendNetMsg.

Ejemplo:
; ; ; ; ; ; ; ; NetMsgFrom() example -------------------Run this program on the REMOTE computer to 'watch' the activity of the SendNetMsg example. Run that example on local machine. This program will tell you when a player involved in the game hits a wall ...

NetMsgTo()
Definicin:
Devuelve el ID del recipiente de un mensaje network.

Descripcin de los Parmetros:

Ninguno.

Descripcin del Comando:

Esto SLO funciona cuando te has unido a un juego en red va StartNetGame o JoinNetGame y has creado un jugador mediante la funcin CreateNetPlayer (debes crear un jugador primero). Debes haber recibido el mensaje otra vez, determinado por el comando RecvNetMsg() - y probablemente el tipo de mensaje sea determinado con NetMsgType(). El valor devuelto por este comando es el ID del recipiente del mensaje que le fue asignado cuando fue creado con CreateNetPlayer. Usars NetMsgType(), NetMsgFrom() y NetMsgData$() para obtener otra informacin importante sobre el mensaje y actuar sobre l. El ejemplo requiere ser ejecutado tambin en un ordenador remoto mientras el ordenador local usa el comando SendNetMsg.

Ayuda Blitz Basic

Ejemplo:
; ; ; ; ; ; ; ; NetMsgTo() example -------------------Run this program on the REMOTE computer to 'watch' the activity of the SendNetMsg example. Run that example on local machine. This program will tell you when a player involved in the game hits a wall ...

NetMsgData$()
Definicin:
Devuelve el mensaje actual de un mensaje network.

Descripcin de los Parmetros:

Ninguno.

Descripcin del Comando:

Esto SLO funciona cuando te has unido a un juego en red va StartNetGame o JoinNetGame y has creado un jugador mediante la funcin CreateNetPlayer (debes crear un jugador primero). Debes haber recibido el mensaje otra vez, determinado por el comando RecvNetMsg() - y probablemente el tipo de mensaje sea determinado con NetMsgType(). La cadena de texto devuelta por este comando es el actual mensaje de texto que fue enviado. Usars NetMsgType(), NetMsgFrom() y NetMsgTo() para obtener otra informacin importante del mensaje y actuar sobre esta. El ejemplo requiere ser ejecutado tambin en un ordenador remoto mientras el ordenador local usa el comando SendNetMsg.

Ejemplo:
; ; ; ; ; ; NetMsgData$() example -------------------Run this program on the REMOTE computer to 'watch' the activity of the SendNetMsg example. Run that example on local machine.

84 ; This program will tell you when a player involved in ; the game hits a wall ... ; We'll use this instead of JoinHostGame - make it easier StartNetGame() ; Create a player - a player must be created to ; receive mesages! playerID=CreateNetPlayer("Shane") ; Loop and get status While Not KeyHit(1) ; Check to see if we've received a message If RecvNetMsg() Then ; if we did, let's figure out what type it is ; we know it will be a user message, though msgType=NetMsgType() ; 1-99 means a user message If msgType>0 And msgType<100 Then ; Let's see who the message was from msgFrom=NetMsgFrom() ; Let's get the message! msgData$=NetMsgData$() ; Print the message Print msgData$ Print "(Message was to:"+ NetMsgTo() + ")" End If End If Wend

Ayuda Blitz Basic

SendNetMsg type,data$,from,to,reliable
Definicin:
Sends a message during a network game.

Descripcin de los Parmetros:

type = valor 1-99 data$ = cadena que contiene el mensaje a enviar from = ID del jugador remitente to = ID del jugador de destino (0=broadcast) reliable = flag para realizar un envo seguro

Descripcin del Comando:

Esto SLO funciona cuando te has unido a un juego en red va StartNetGame o JoinNetGame y has creado un jugador mediante la funcin CreateNetPlayer (debes crear un jugador primero). ste es probablemente el comando de red ms complicado. Sirve ra enviar un mensaje a uno o todos los jugadores del juego en red. Los otros jugadores usarn RecvNetMsg() para interceptar tu mensaje. El parmetro TYPE es un nmero entre 1 y 99. Estos valores son conocidos como 'mensajes del usuario'. El parmetro Data$ es una cadena de texto que contiene el mensaje a enviar. Es til saber como introducir el mayor nmero de datos posible en un solo mensaje para mejorar la velocidad. Por ejemplo, podras enviar X, Y, y FRAME en una sola cadena como "200,100,4". FROM es el ID del jugador que enva el mensaje. Es el valor devuelto por el comando CreateNetPlayer(). TO es el ID del jugador a quien quieres enviar el mensaje. El valor 0 mandar el mensaje a todos los jugadores. El flag RELIABLE asegurar que el mensaje no se pierda. Sin embargo, es al menos 3 veces ms lento que un mensaje normal. El ejemplo requiere ser ejecutado en el ordenadro local y en uno remotole ejecutar el del comando RecvNetMsg().

Ejemplo:
; ; ; ; SendNetMsg example -----------------Run this example on the local computer run the example for RecvNetMsg() on a remote computer

; Graphics mode with double buffering

Ayuda Blitz Basic Graphics 640,480,16 SetBuffer BackBuffer() ; Create a network game with NO requester joinStatus=HostNetGame("ShaneGame") ; A type to hold all the player's information Type multi Field x Field y Field id Field name$ Field xspeed Field boxColor End Type ; make sure the game started ok... If joinStatus=2 Then Print "Hosted game started... " Else Print "Hosted game could not be started!" End End If ; Create 5 local players using TYPEs For t = 1 To 5 ; New type instance player.multi = New Multi ; Assign the ID field with the created player ID and name him player\ID=CreateNetPlayer("Player" + t) ; if the player was created ok ... assign some random parameters If player\ID <> 0 Then player\name$="Player" + t player\x = Rand(640) player\y = Rand(480) player\boxColor = Rand(255) player\xspeed = Rand(1,5) ; Print some text results Print "Player " + t + " has joined the game with ID=" + player\ID Else Print "The player couldn't join! Aborting!" End If Next ; We've got them all! Wait for a key Print "All local players are joined! Press a key ..." WaitKey() ; Loop this routine While Not KeyHit(1) Cls ; for each of the players, update their locations on the screen For player = Each multi Color player\boxColor,player\boxColor,player\boxColor Rect player\x,player\y,10,10,1 Text player\x-10,player\y-15,player\name$ player\x = player\x + player\xspeed If player\x > 640 Or player\x < 0 Then player\xspeed=-player\xspeed message$="Player ID #" + player\ID + " hit a wall!" ; Send a broadcast message if a player rebounds off the wall ; this message will show up on the remote machine SendNetMsg Rand(1,99),message$,player\id,0 End If Next Flip Wend End

Ayuda Blitz Basic

DIRECTSHOW OpenMovie( file$ )

Parmetros:
file$ - nombre de archivo de la pelcula

Descripcin:
Abre un vdeo y devuelve su handle.

CloseMovie movie
Parmetros:
movie - handle a la pelcula

Descripcin:
Cierra una pelcula.

DrawMovie movie,x,y,[,width,height]
Parmetros:
movie - handle del vdeo x - posicin x de la esquina superior izquierda del vdeo y - posicin y de la esquina superior izquierda del vdeo width (opcional) - ancho del vdeo. Por defecto el ancho original del vdeo. height (opcional) - altura del vdeo. Por defecto la altura original del vdeo.

Descripcin:
Dibuja un vdeo en el buffer actual. Devuelve True si el vdeo todava se est reproduciendo. El soporte de vdeos depende de DirectShow, as que debers asegurarte de que tienes los drivers correctamente instalados. Los vdeos se movern normalmente ms rpidos con su tamao original.

MovieWidth( movie )
Parmetros:
movie - handle del vdeo

Descripcin:
Devuelve el ancho de un vdeo.

MovieHeight( movie )
Parmetros:
movie - handle del vdeo

Descripcin:
Devuelve la altura de un vdeo.

MoviePlaying( movie )
Parmetros:
movie - handle del vdeo

Descripcin:
Devuelve 1 (true) si la pelcula especificada est siendo reproducida.

Ayuda Blitz Basic

Descripcin del Comando:

Cambia el volumen de un efecto de sonido usando este comando. Este comando usa nmeros de coma flotante de 0 a 1 para controlar el volumen. Por favor, mira ChannelVolume para ms opciones.

Ejemplo:
; Load sound sample sndDeath=LoadSound("audio\death.wav") ; Change volume level to half SoundVolume sndDeath,.5

Ayuda Blitz Basic ; Play sound PlaySound sndDeath

SoundPan sound_variable,pan# Definicin: Cambia el balance del efecto de sonido especificado. Descripcin de los Parmetros: sound_variable = handle del sonido obtenido al cargarlo con el comando LoadSound. pan# = nmero de coma flotante desde -1 (izquierda) a 0 (centro) a 1 (derecha) Descripcin del Comando: Usa este comando para cambiar el balance de tu sonido entre los altavoces izquierdo y derecho (o restaurarlo al centro). Ejemplo: ; Load sound sample sndDeath=LoadSound("audio\death.wav") ; Pan sound effect half to the left SoundPan sndDeath,-.5 ; Play sound PlaySound sndDeath

PlaySound sound_variable
Definicin:
Reproduce un sonido cargado previamente en memoria.

Descripcin de los Parmetros:

sound_variable = handle del sonido obtenido al usar el comando

Descripcin del Comando:

Reproduce un sonido cargado previamente. Mira el ejemplo. Necesitars asignar un handle de canal al sonido cuando lo reproduzcas. Todas las subsecuentes operaciones con el sonido necesitan usar el handle del CANAL, no del sonido - como StopChannel, PauseChannel, ResumeChannel, ChannelPitch, ChannelVolume, ChannelPan y ChannelPlaying.

Ejemplo:
; Assign a global variable for the sound Global sndPlayerDie ; Load the sound file into memory sndPlayerDie=LoadSound("sounds/die.wav") ; Play the sound chnDie=PlaySound sndPlayerDie

Este comando remplaza a StopSound en las ltimas versiones de Blitz Basic. Una vez tengas a un sonido reproduciendo y un canal asociado a ste, usa este comando para parar el sonido. Trabaja con todo tipo de canales de sonido, incluyendo MP3, WAV, MIDI y CD.

Ayuda Blitz Basic

Ejemplo:
; Ejemplo Channel Print "Cargando sonido ..." ; Carga el ejemplo - necesitars tener este sonido en tu ordenador ; para mejores resultados, cralo alrededor de 5-10 segundos... sndWave=LoadSound("level1.wav") ; Prepara el sonido para reproducirlo infinitas veces LoopSound sndWave chnWave=PlaySound(sndWave) Print "Reproduciendo el sonido durante 2 segundos..." Delay 2000 Print "Parando el sonido durante 2 segundos..." PauseChannel chnWave Delay 2000 Print "Volviendo a reproducir el sonido..." ResumeChannel chnWave Delay 2000 Print "Cambiando la frecuencia del sonido..." ;StopChannel chnWave ChannelPitch chnWave, 22000 Delay 2000 Print "Reproduciendo el sonido con la nueva frecuencia..." Delay 2000 Print "Slo el altavoz izquierdo" ChannelPan chnWave,-1 Delay 2000 Print "Slo el altavoz derecho" ChannelPan chnWave,1 Delay 2000 Print "Todo hecho!" StopChannel chnWave

PauseChannel channel_handle
Definicin:
Para la reproduccin de un canal de sonido.

Descripcin de los Parmetros:

channel_handle = handle del canal

Descripcin del Comando:

Cuando ests reproduciendo un canal de sonido, puede llegar un momento en que desees pausar el sonido por alguna razn (p.e. para reproducir otro efecto de sonido). Este comando lo hace - y el canal puede ser resumido con el comando ResumeChannel. Puedes usar StopChannel para parar el sonido.

Ejemplo:
Ver Ejemplo Channel

ResumeChannel channel
Parmetros:
channel - un canal de msica o sonido asignado previamente con LoadSound, PlayMusic, etc.

Descripcin:
ResumeChannel se usa para continuar la reproduccin de un sonido o pista de msica del canal dado despus de que parars temporalmente su reproduccin con el comando PauseChannel.

buffer = buffer de destino filename$ = ruta completa y nombre del archivo

Descripcin del Comando:

Hay mil y un usos para este comando, pero probablemente el ms usado podra ser mostrar una pantalla de ttulo o alguna otra imagen que slo sea una vez vista (como en nuestro ejemplo). Tambin puedes cargarlas en el image buffer o back buffer. La imagen se escala para que coincida con el tamao del buffer. Este comando devuelve 1 si no hubo ningn error, 0 en caso contrario.

Ejemplo:
; LoadBuffer example ; Set graphics mode Graphics 800,600,16 ; Load an image directly to the front buffer (your location may be different) LoadBuffer (FrontBuffer(),"C:\Program Files\Blitz Basic\samples\blitzanoid\gfx\title.bmp") ; wait for ESC so user gets to see the screen While Not KeyHit(1) Wend

SaveBuffer (buffer,filename$)
Definicin:
Guarda el buffer de vdeo seleccionado en un archivo bitmap.

Descripcin de los Parmetros:

buffer = buffer a guardar; FrontBuffer() o BackBuffer() filename$ = ruta completa/nombre de archivo

Descripcin del Comando:

Normalmente se usa para obtener una captura de pantalla. Este comando guardar el buffer que hayas especificado en un archivo .bmp. Recuerda, usa el nombre del buffer que desees guardar; FrontBuffer() para lo que hay actualmente visible en pantalla, y BackBuffer() para lo que hay detrs.

Ayuda Blitz Basic

Ejemplo:
; Save the screen when player pushes F10 If KeyHit(10) Then SaveBuffer(FrontBuffer(),"screenshot.bmp") End If

LockBuffer buffer
Definicin:
Bloquea un buffer para aumentar la velocidad de las operaciones con pixels.

Descripcin de los Parmetros:

buffer = buffer a bloquear (opcional)

Descripcin del Comando:

Despus de aplicar LockBuffer sobre un buffer, los nicos comandos grficos que puedes utilizar son ReadPixel, WritePixel, ReadPixelFast, WritePixelFast, CopyPixelFast, y CopyPixel. Debes usar UnlockBuffer antes de usar otros comandos grficos. El parmetro 'buffer' no es indispensable. Si se omite, el buffer por defecto ser el establecido con la funcin SetBuffer. Mira los otros comandos para ms informacin.

Ejemplo:
; Comandos Grficos de Alta Velocidad Graphics 640,480,16 ; Dibujo un montn de mierda en la pantalla For t= 1 To 1000 Color Rnd(255),Rnd(255),Rnd(255) Rect Rnd(640),Rnd(480),Rnd(150),Rnd(150),Rnd(1) Next Delay 3000 ; Copio la mitad superior de la pantalla encima de la inferior ; usando los 'fast pixels' y buffer's bloqueados For x = 1 To 640 For y = 1 To 240 LockBuffer FrontBuffer() WritePixelFast x,y+241,ReadPixelFast(x,y) UnlockBuffer FrontBuffer() Next Next Delay 3000 ; Dibujo la mitad izquierda de la pantalla sobre la derecha ; usando los 'slow pixels' y buffer's desbloqueados For x = 1 To 320 For y = 1 To 480 WritePixel x+320,y,ReadPixel(x,y) Next Next

UnlockBuffer buffer
Definicin:
Desbloquea el buffer previamente bloqueado para realizar operaciones de pixels rpidas.

Descripcin de los Parmetros:

buffer = un buffer de pantalla/imagen vlido (opcional)

Descripcin del Comando:

Despus de usar LockBuffer sobre un buffer, los nicos comandos grficos que puedes usar son ReadPixel, WritePixel, ReadPixelFast y WritePixelFast. Debes usar este comando antes de utilizar otros comandos grficos.

Ayuda Blitz Basic El parmetro buffer no es necesario. Si se omite, el buffer establecido con el comando SetBuffer ser usado. Mira los otros comandos para ms informacin.

ReadPixel (x,y,[buffer])
Parmetros:
x - coordenada x y - coordenada y buffer (opcional) - nombre del buffer donde se leer el pixel, p.e. BackBuffer()

Descripcin:
Lee un valor de color del buffer actual o del especificado, y lo devuelve. El valor devuelto est en la forma de un entero que contiene los valores alfa, rojo, verde y azul del pixel. Puedes usar este comando en un buffer bloqueado para aligerar la velocidad. Mira LockBuffer. Mira tambin: GetColor, ReadPixelFast.

Ejemplo:
; ReadPixel/WritePixel Example ; ---------------------------Graphics 640,480,16 Print "Press a key to read color values (this may take a few seconds)" WaitKey() ; Load and draw an image on to the screen - can be anything pic=LoadImage("media/blitz_pic.bmp") DrawImage pic,0,0 ; Initialise an array big enough to fit all the color information of the screen Dim pix(GraphicsWidth(),GraphicsHeight()) ; Use ReadPixel to get all the color information of the screen For y=0 To GraphicsHeight() For x=0 To GraphicsWidth() pix(x,y)=ReadPixel(x,y) Next Next Cls Locate 0,0 Print "Press a key to write pixels (this may takes a few seconds)" Print "Once this has finished, you can then press a key to end the program" WaitKey() ; Use WritePixel to redraw the screen using the color information we got earlier For y=0 To GraphicsHeight() For x=0 To GraphicsWidth() WritePixel x,y,pix(x,GraphicsHeight()-y) ; get y array value in backwards order, to flip screen Next Next WaitKey()

WritePixel x,y,argb,[buffer]
Parmetros:
x - coordenada x y - coordenada y argb - valor de color argb del pixel (alpha (alfa), red (rojo), green (verde), blue(azul)) buffer (opcional) - nombre del buffer de destino, por ejemplo, BackBuffer()

Descripcin:
Escribe un valor de color en el buffer especificado. Puedes usar este comando en un buffer bloqueado para mejorar la velocidad. Mira LockBuffer. Mira tambin: Plot, WritePixelFast.

Ayuda Blitz Basic

Ejemplo:
; ReadPixel ReadPixelFast (x,y,[buffer]) Parmetros: x - coordenada x y - coordenada y

buffer (opcional) - nombre del buffer donde se leer el pixel, p.e. BackBuffer()
Descripcin:
Lee un valor de color del buffer actual o del especificado, y lo devuelve. El valor devuelto est en la forma de un entero que contiene los valores alfa, rojo, verde y azul del pixel. IMPORTANTE: DEBES usar este comando en un buffer bloqueado, de lo contrario el comando fallar. Mira LockBuffer. Tambin debes asegurarte de que las coordenadas que ests leyendo son vlidas. CUIDADO: Si no sigues el anterior aviso, puedes cargarte tu Pc. Mira tambin: GetColor, ReadPixel.

Ejemplo:
; ReadPixelFast/WritePixeFast Example Graphics 640,480,16 Print "Press a key to read color values" WaitKey() ; Load and draw an image on to the screen - can be anything pic=LoadImage("media/blitz_pic.bmp") DrawImage pic,0,0 ; Initialise an array big enough to fit all the color information of the screen Dim pix(GraphicsWidth(),GraphicsHeight()) ; Lock buffer before using ReadPixelFast LockBuffer ; Use ReadPixel to get all the color information of the screen For y=0 To GraphicsHeight() For x=0 To GraphicsWidth() pix(x,y)=ReadPixelFast(x,y) Next Next ; Lock buffer after using ReadPixelFast UnlockBuffer Cls Locate 0,0 Print "Press a key to write pixels" Print "Once this has finished, you can then press a key to end the program" WaitKey() ; Lock buffer before using WritePixelFast LockBuffer ; Use WritePixel to redraw the screen using the color information we got earlier For y=0 To GraphicsHeight() For x=0 To GraphicsWidth() WritePixelFast x,y,pix(x,GraphicsHeight()-y) ; get y array value in backwards order, to flip screen Next Next ; Unlock buffer after using WritePixelFast UnlockBuffer WaitKey()

Ayuda Blitz Basic

WritePixelFast x,y,argb,[buffer]
Parmetros:
x - coordenada x y - coordenada y argb - valor de color argb del pixel (alpha (alfa), red (rojo), green (verde), blue(azul)) buffer (opcional) - nombre del buffer de destino, por ejemplo, BackBuffer()

Descripcin:
Escribe un valor de color en el buffer especificado. IMPORTANTE: DEBES usar este comando sobre un buffer bloqueado, sino el comando fallar. Mira LockBuffer. Tambin debes asegurarte de que las coordenadas especificadas son vlidas, sino acabars sobreescribiendo otras reas de memoria. CUIDADO: Si no sigues la advertencia anterior, puedes bloquear tu ordenador. Mira tambin: Plot, WritePixel.

Ejemplo:
; ReadPixelFast

CopyPixel src_x,src_y,src_buffer,dest_x,dest_y,[dest_buffer]
Parmetros:
src_x - coordenada x del pixel que se copiar. src_y - coordenada y del pixel que se copiar src_buffer - nombre del buffer desde donde se copiar, p. e. ImageBuffer(). dest_x - coordenada x del pixel donde se copiar dest_y - coordenada y del pixel donde se copiar. dest_buffer (optional) - nombre del buffer donde se copiar, p. e. BackBuffer()

Descripcin:
Copia un pixel en otra localizacin. Puedes usar este comando en un buffer bloqueado para aumentar velocidad. Mira LockBuffer. Mira tambin: CopyPixelFast.

Ejemplo:
; CopyPixel/CopyPixelFast Example Graphics 640,480,16 Print "Press a key to use CopyPixel to copy the top half of an image to the frontbuffer" WaitKey() ; Load an image - can be anything pic=LoadImage("media/blitz_pic.bmp") ; Use CopyPixel to copy the top half of the image to the frontbuffer For y=0 To ImageHeight(pic)/2 For x=0 To ImageWidth(pic) CopyPixel x,y,ImageBuffer(pic),x,y Next Next Locate 0,GraphicsHeight()/2 Print "Press a key to use CopyPixelFast to copy the bottom half of the image" Print "Once this has finished, you can then press a key to end the program" WaitKey() ; Lock buffer before using CopyPixelFast LockBuffer ; Use CopyPixelFast to copy the bottom half of the image to the frontbuffer For y=0 To (ImageHeight(pic)/2)+ImageHeight(pic) For x=0 To ImageWidth(pic) CopyPixelFast x,y,ImageBuffer(pic),x,y Next Next ; Unlock buffer after using CopyPixelFast UnlockBuffer WaitKey()

100

Ayuda Blitz Basic

CopyPixelFast src_x,src_y,src_buffer,dest_x,dest_y,[dest_buffer]
Parmetros:
src_x - coordenada x del pixel que se copiar. src_y - coordenada y del pixel que se copiar src_buffer - nombre del buffer desde donde se copiar, p. e. ImageBuffer(). dest_x - coordenada x del pixel donde se copiar dest_y - coordenada y del pixel donde se copiar. dest_buffer (optional) - nombre del buffer donde se copiar, p. e. BackBuffer()

Descripcin:
Copia un pixel en otra localizacin. IMPORTANTE: *DEBES* usar este comando en un buffer BLOQUEADO, sino fallar. Mira LockBuffer. Tambin debes asegurarte de que las coordenadas especificadas son vlidas, sino acabar sobreescribiendo otras reas de memoria. ATENCIN: Si no haces caso de la anterior advertencia, puedes hacer que tu ordenador se bloquee. Mira tambin: CopyPixel.

Ejemplo:
Ver CopyPixel

CopyRect src_x,src_y,src_width,src_height,dest_x,dest_y,[src_buffer],[dest_buffer]
Definicin: Copia un rectngulo de grficos desde un buffer a otro. Descripcin de los Parmetros:
src_x = coordenada x desde donde se empezar a copiar. src_y = coordenada y desde donde se empezar a copiar src_width = anchura del rea a copiar. src_height = altura del rea a copiar dest_x = coordenada x de destino. dest_y = coordenada y de destino src_buffer = handle del buffer de imagen de origen (opcional). dest_buffer = handle del buffer de imagen de destino (opcional)

Descripcin del Comando:

Copia un rectngulo de grficos desde un buffer a otro. Si el buffer es omitido, se usar el buffer actual.

vwait = establece a TRUE para esperar a la sincronizacin vertical para acabar

102

Ayuda Blitz Basic

Descripcin del Comando:

Cuando ests en doble buffering (o haciendo operaciones de dibujo en el BackBuffer(), y hayas dibujado todos tus elementos) necesitars 'voltear' el Backbuffer para que sea visible en el FrontBuffer(). Este comando realiza esta funcin. ste te permite dibujar muchos grficos rpidamente y voltearlos a la vista. Mira BackBuffer() para ms informacin.

VWait [frames]
Definicin:
Espera a que acaben uno o ms "barridos" o ciclos verticales de la pantalla antes de continuar. Descripcin de los Parmetros: [frames] = nmero opcional de frames a esperar

Descripcin del Comando:

Hay veces que quieres dibujar muy rpido, y tus operaciones de dibujo lo son tanto que ocurren cosas indeseables. Este comando fuerza a Blitz a esperar hasta que la 'lnea' de dibujo alcance el tope inferior de la pantalla antes de continuar. Prueba el ejemplo con y sin el comando VWAIT.

Ejemplo:
; Ejemplo Vwait Graphics 800,600,16 ; Espera que pulses ESC para acabar While Not KeyHit(1) ; Establece un color aleatorio Color Rnd(255),Rnd(255),Rnd(255) ; Dibuja una lnea aleatoria Line Rnd(800),Rnd(600),Rnd(800),Rnd(600) ; Espera que acabe un ciclo vertical para continuar con el bucle VWait Wend

rojo, verde y azul = nmero entre 0 y 255

Descripcin del Comando:

ste cambia el color para las siguientes llamadas a un CLS. Usa este comando cuando necesitas CLS para 'borrar' la pantalla con algn otro color que no sea negro.

Ejemplo:
;set ClsColor to red ClsColor 255,0,0 ;set current drawing buffer to the color set by the ClsColor command Cls

Ayuda Blitz Basic Cls Definicin: Borra el buffer de dibujo actual. Descripcin de los Parmetros: Ninguno. Descripcin del Comando:

105

Este comando vaciar el buffer de dibujo actual de todos los grficos y textos presentes y reinicia el buffer de dibujo al color definido con el comando ClsColor. Ejemplo: ;set ClsColor to red ClsColor 255,0,0 ;set current drawing buffer to the color set by the ClsColor command Cls

Plot x,y
Definicin:
Pone un pixel en la pantalla del color actual de dibujo.

Descripcin de los Parmetros:

x= un n desde 0 hasta el ancho del actual modo grfico y= un n desde 0 hasta el alto del actual modo grfico

Descripcin del Comando:

Ejemplo:
; Oval example Graphics 800,600,16 ; Wait for ESC to hit While Not KeyHit(1) ; Set a random color Color Rnd(255),Rnd(255),Rnd(255) ; Draw a random oval Oval Rnd(800),Rnd(600),Rnd(100),Rnd(100),Rnd(0,1) Wend

Ayuda Blitz Basic

107

GetColor x, y
Definicin:
Establece el color de dibujo actual al color del pixel designado.

Descripcin de los Parmetros:

x = coordenada x del pixel y = coordenada y del pixel

Descripcin del Comando:

Este comando trabaja como un capturador de color.

Ejemplo:
; GetColor Example Graphics 320,200 SetBuffer BackBuffer() For t = 1 To 1000 Color Rnd(255), Rnd(255), Rnd(255) Rect Rnd(320),Rnd(200),10,10,1 Next GetColor 100,100 Print "Box at 100,100 is RGB:" + ColorRed() + "," + ColorGreen() + "," + ColorBlue() + "!" Flip While Not KeyHit(1) Wend

ColorRed()
Definicin:
Devuelve el componente rojo del color de dibujo actual.

Descripcin de los Parmetros:

Ninguno.

Descripcin del Comando:

Usa este comando para devolver el componente verde del color RGB del color de dibujo actual. Usa ColorBlue() y ColorGreen() para los otros dos componentes de color.

Ejemplo:
; Color

ColorGreen() Definicin: Devuelve el componente verde del color de dibujo actual. Descripcin de los Parmetros: Ninguno. Descripcin del Comando: Usa este comando para devolver el componente verde del color RGB del color de dibujo actual. Usa ColorRed() y ColorBlue() para los otros dos componentes de color. Ejemplo: ; Color

Algunos ordenadores pueden tener ms de una tarjeta de vdeo. Una vez que saves cuntos drivers hay instalados, puedes conseguir sus nombres con el comando GfxDriverName$ y mostrarlos para elegir cul usar. Una vez que el usuario lo ha elegido, puedes seleccionar la tarjeta grfica que vas a utilizar con SetGfxDriver. Normalmente, esto no ser necesario en programacin 2D.

Ejemplo:
; GfxDriver Examples ; Count how many drivers there are totalDrivers=CountGfxDrivers() Print "Choose a driver to use:" ; Go through them all and print their names (most people will have only 1)

Ayuda Blitz Basic For t = 1 To totalDrivers Print t+") " + GfxDriverName$(t) Next ; Let the user choose one driver=Input("Enter Selection:") ; Set the driver! SetGfxDriver driver Print "Your driver has been selected!"

109

CountGfxDrivers()
Definicin:
Devuelve el nmero de tarjetas grficas de tu sistema.

Descripcin de los Parmetros:

Ninguno.

Descripcin del Comando:

Ejemplo:
Ver GfxDriver Examples

SetGfxDriver index
Definicin:
Selecciona el controlador grfico a utilizar para los comandos de dibujo.

Descripcin de los Parmetros:

index = nmero obtenido con el comando CountGfxDrivers

Descripcin del Comando:

Algunos ordenadores tienen ms de una tarjeta de vdeo/controlador grfico instalado (un buen ejemplo es un ordenador con una tarjeta de vdeo primaria y una Voodoo2 u otra tarjeta grfica). Una vez sepas cuntos controladores hay usando el comando CountGfxDrivers(), puedes mostrarlos usando GfxDriverName$ para que el usuario elija el que quiera. Una vez el usuario haya elegido (o t), puedes establecerlo con este comando. Normalmente esto no ser necesario en programas 2D.

Ejemplo:
Ver GfxDriver Examples

GFXModeWidth (mode)
Definicin:
Devuelve el ancho del modo de vdeo actual.

Descripcin de los Parmetros:

Ninguno.

Descripcin del Comando:

Una vez sepas los modos de vdeo disponibles usando CountGFXModes(), puedes cambiarlos determinando el ancho, alto y la profundidad de color. Usa este comando para obtener el ancho del modo.Usa los comandos GFXModeHeight y GFXModeDepth para obtener los parmetros restantes.

Ejemplo:
Ver CountGFXModes

Usa este comando para verificar que la tarjeta grfica del usuario soporta un modo en concreto. Devuelve TRUE si el modo existe, FALSE si no. Si quieres saber que nmero de modo es, usa FindGFXMode.

Ejemplo:
; GFXModeExists example ; If there is a mode, tell user mode=GfxModeExists(800,800,16) If mode=1 Then Print "The mode you requested exists!" Else Print "Sorry, that mode doesn't exist." End If ; Wait for ESC press from user While Not KeyHit(1) Wend

TotalVidMem()
Parmetros:
Ninguno.

Descripcin:
TotalVidMem () simplemente devuelve el total de memoria disponible en la tarjeta grfica, en bytes. Fjate que para saber la memoria disponible actualmente en bytes, deberas usar AvailVidMem ().

Ayuda Blitz Basic

111

Ejemplo:
Print "Total de memoria grfica disponible: " + TotalVidMem () + " bytes." ; NOTA: Para saber la memoria grfica *disponible*, usa AvailVidMem ()!

AvailVidMem()
Definicin:
Devuelve la memoria de video disponible.

Descripcin de los Parmetros:

Ninguno.

Descripcin del Comando:

Este comando devolver el nmero total de bytes disponibles de la memoria de video. salo para saber el estado de tus recursos.

width=ancho de la nueva imagen (o sus frames) height=altura de la nueva imagen frames= numero de frames opcional (se omite si slo tiene un frame)

Descripcin del Comando:

Algunas veces quieres crear una imagen nueva al vuelo (usando otras imgenes, con comandos de dibujo, etc.) en vez de cargar una. Este comando te permitir crear una imagen nueva con uno o varios frames para una animacin. Especificas la anchura, altura y el nmero de frames opcional. El ejemplo puede ser interesante.

Ayuda Blitz Basic ; Only update the screen every 300 milliseconds. Change 300 for faster or ; slower screen updates If MilliSecs() > tmrScreen+300 Then Cls ; clear the screen ; Tile the screen with a random frame from our new graphic starting at ; x=0 and y=0 location. TileImage gfxStarfield,0,0,Rnd(9) Flip ; Flip the screen into view tmrScreen=MilliSecs() ; reset the time End If Wend

113

image = handle de la imagen x = localizacin x de inicio para capturar la imagen y = localizacin y de inicio para capturar la imagen frame = frame para meter la imagen (opcional)

Descripcin del Comando:

Seguramente uno de los ms tiles y confusos comandos en Blitz Basic sea GrabImage. Este comando te permite grabar una porcin del actual buffer de dibujo (esto puede ser una imagen tambin si has establecido el buffer como ImageBuffer) y lo mete en una imagen. Hay mil y un usos para este comando, slo necesitas imaginacin. Primero debes usar el comando CreateImage para crear una nueva imagen vaca en la que grabars. Su tamao debe ser igual o mayor al de la imagen a capturar. Por ejemplo, creas una nueva imagen con un tamao de 50 pixels por 50 pixels. Cuando llamas a GrabImage, eliges x=100, y=100. El rea que grabars y pondrs en tu nueva imagen ser de 100,100 a 150,150. Si intentas usar GrabImage en una imagen que no existe, recibirs un error. Nota: Puedes REMPLAZAR una imagen existente. Mira el ejemplo para ms informacin.

Ejemplo:
; GrabImage example ; Turn on graphics Graphics 640,480,16 ; We'll be drawing right to the front buffer SetBuffer FrontBuffer() ; You must create an empty image to grab from first gfxGrab=CreateImage(100,100) ; Draw random rectangles on the screen until the ; user presses ESC While Not KeyHit(1) ; random color Color Rnd(255),Rnd(255),Rnd(255) ; super random rectangles Rect Rnd(640),Rnd(480),Rnd(100),Rnd(100),Rnd(1) Delay 50 Wend ; Now, grab an image, starting at 100,100 and put it in gfxGrab GrabImage gfxGrab,100,100 ; Clear screen and show user the grabbed image Cls Text 0,0, "Here is your grabbed image! Press a mouse key ..." DrawImage gfxgrab,50,50 ; Wait for a mouse press WaitMouse()

ImageBuffer (handle[,frame])
Definicin:
Se usa para especificar una imagen y un frame para realizar operaciones de dibujo directamente. Descripcin de los Parmetros: handle=handle de la imagen frame=nmero de frame (opcional)

116

Ayuda Blitz Basic

Descripcin del Comando:

Hay 1000 usos para este comando. Puedes dibujar en una imagen que hayas cargado (LoadImage o LoadAnimImage) o creado (CreateImage). Podras, por ejemplo, tener un grfico de un muro y quieres aadirle un 'graffiti' basado en la accin del usuario. En vez de intentar dibujar una docena de imgenes encima del muro, slo usa SetBuffer para especificar el grfico del muro como buffer 'objetivo', y dibuja encima! La prxima vez que dibujes este grfico (DrawImage), vers los cambios. Es un comando muy poderoso!

Ejemplo:
; CreateImage/TileImage/ImageBuffer example ; Again, we'll use globals even tho we don't need them here ; One variable for the graphic we'll create, one for a timer Global gfxStarfield, tmrScreen ; Declare graphic mode Graphics 640,480,16 ; Create a blank image that is 320 pixels wide and 32 high with 10 frames of 32x32 gfxStarfield=CreateImage(32,32,10) ; loop through each frame of the graphic we just made For t = 0 To 9 ; Set the drawing buffer to the graphic frame so we can write on it SetBuffer ImageBuffer(gfxStarfield,t) ; put 50 stars in the frame at random locations For y = 1 To 50 Plot Rnd(32),Rnd(32) Next Next ; Double buffer mode for smooth screen drawing SetBuffer BackBuffer() ; Loop until ESC is pressed While Not KeyHit(1) ; Only update the screen every 300 milliseconds. Change 300 for faster or ; slower screen updates If MilliSecs() > tmrScreen+300 Then Cls ; clear the screen ; Tile the screen with a random frame from our new graphic starting at ; x=0 and y=0 location. TileImage gfxStarfield,0,0,Rnd(9) Flip ; Flip the screen into view tmrScreen=MilliSecs() ; reset the time End If Wend

DrawImage handle,x,y,[frame]
Definicin: Dibuja una imagen o frame de una imagen animada en la pantalla. Descripcin de los Parmetros:
handle = handle de la imagen. x = localizacin x de la pantalla donde se dibujar el grfico y = localizacin y de la pantalla donde se dibujar el grfico. frame = nmero del frame a mostrar (opcional - 0 por defecto)

Descripcin del Comando:

Este comando dibuja una imagen previamente cargada. Este comando muestra tanto imgenes simples (cargadas con el comando LoadImage) como imgenes animadas (cargadas con el comando LoadAnimImage). T especificas en qu coordenadas de la pantalla deseas que aparezca la imagen. Puedes dibujarla tambin fuera de la pantalla especificando valores negativos o positivos (mayores que el tamao de la pantalla). Finalmente, si ests usando una imagen animada (cargada con el comando LoadAnimImage), puedes especificar qu frame quieres que se muestre con el comando DrawImage. Uno de los problemas ms comunes con los nuevos programadores Blitz ocurre cuando usando los comandos de dibujo ven a que el grfico no aparece en la pantalla, y nunca lo vern! Recuerda, Blitz Basic es rpido... ms rpido que el ojo humano. Tendrs que redibujar la imagen encima una y otra vez (parecido a los dibujos animados de la TV), limpiando la pantalla cada vez que haces un cambio (esto es llamado doble buffering); o necesitars retrasar la ejecucin de Blitz durante mucho "tiempo humano" para poder VER la imagen.

Ayuda Blitz Basic

117

DrawImageRect image,x,y,rect_x,rect_y,rect_width,rect_height,[frame]
Definicin:
Dibuja un rea rectangular de una imagen en la localizacin especificada.

Descripcin de los Parmetros:

image = handle de la imagen x = localizacin x de la pantalla para dibujar la imagen y = localizacin y de la pantalla para dibujar la imagen rect_x = localizacin x del interior de la imagen para empezar a dibujar rect_y = localizacin y del interior de la imagen para empezar a dibujar rect_width = ancho del rea a dibujar rect_height = altura del rea a dibujar frame = nmero de frame de la imagen a dibujar (opcional)

Descripcin del Comando:

Este comando te permitir dibujar una PORCIN rectangular de una imagen en la posicin especificada de la pantalla. Las partes transparentes de la imagen original no se dibujarn. Esto es til si ests haciendo algo parecido a revelar parte de la pantalla cuando el jugador descubra algo. Si quieres dibujar la porcin de la imagen sin transparencias, usa el comando DrawBlockRect.

Ejemplo:
; DrawImageRect Example ; Turn on graphics mode Graphics 640,480,16 ; Create new empty graphic to store our circle in gfxCircle=CreateImage(50,50) ; Draw the circle image ; Set drawing operations to point to our new empty graphic SetBuffer ImageBuffer(gfxCircle) Color 255,0,0 ; Note the extra space between the circle and the edge of the graphic Oval 10,10,30,30,1 SetBuffer FrontBuffer()

; Let's draw portions of the circle randomly While Not KeyHit(1)

118 ; We take random sized portions of the circle and put them ; at a random location ... wash, rinse, and repeat DrawImageRect gfxCircle,Rnd(640),Rnd(480),0,0,Rnd(50),Rnd(50),0 Delay 100 Wend

Ayuda Blitz Basic

DrawBlockRect image,x,y,rect_x,rect_y,rect_width,rect_height,[frame]
Definicin:
Dibuja un rea rectangular de una imagen en la localizacin especificada sin transparencia.

Descripcin de los Parmetros:

image = handle de la imagen x = localizacin x para dibujar la imagen y = localizacin x para dibujar la imagen rect_x = localizacin x de inicio dentro de la imagen a dibujar rect_y = localizacin y de inicio dentro de la imagen a dibujar rect_width = altura del rea a dibujar rect_height = ancho del rea a dibujar frame = frame de la imagen a dibujar (opcional)

Descripcin del Comando:

Este comando te permitir dibujar una PORCIN rectangular de una imagen en la localizacin especificada de la pantalla. Las porciones transparentes de la imagen original sern ignoradas y dibujadas con la imagen. Si quieres dibujar una porcin de imagen con transparencia, usa el comando DrawImageRect.

Ejemplo:
; DrawBlockRect Example ; Turn on graphics mode Graphics 640,480,16 ; Create new empty graphic to store our circle in gfxCircle=CreateImage(50,50) ; Draw the circle image ; Set drawing operations to point to our new empty graphic SetBuffer ImageBuffer(gfxCircle) Color 255,0,0 ; Note the extra space between the circle and the edge of the graphic Oval 10,10,30,30,1 SetBuffer FrontBuffer() ; Set the screen to white so you can see the transparent areas ClsColor 255,255,255 Cls ; Let's draw portions of the circle randomly While Not KeyHit(1) ; We take random sized portions of the circle and put them ; at a random location ... wash, rinse, and repeat DrawBlockRect gfxCircle,Rnd(640),Rnd(480),0,0,Rnd(50),Rnd(50),0 Delay 100 Wend

DrawBlock image,x,y,[frame]
Definicin:
Dibuja una imagen en una localizacin sin respetar la transparencia.

Descripcin de los Parmetros:

image = handle de la imagen x = localizacin x para dibujar la imagen y = localizacin x para dibujar la imagen frame = frame de la imagen a dibujar (opcional - por defecto 0)

Ayuda Blitz Basic

119

Descripcin del Comando:

ste es similar al comando DrawImage excepto que la transparencia o el MaskImage es ignorado y se dibuja la imagen entera. El frame es opcional.

Ejemplo:
; DrawBlock Example ; Turn on graphics mode Graphics 640,480,16 ; Create new empty graphic to store our circle in gfxCircle=CreateImage(50,50) ; Draw the circle image ; Set drawing operations to point to our new empty graphic SetBuffer ImageBuffer(gfxCircle) Color 255,0,0 ; Note the extra space between the circle and the edge of the graphic Oval 10,10,30,30,1 ; Let's not forget to put the drawing buffer back! SetBuffer BackBuffer() ; Set the CLS color to white ClsColor 255,255,255 ; Let the ; putting While Not Cls DrawBlock Flip Wend user move the circle graphic around a white screen the graphic at the MouseX,Y coordinates KeyHit(1) gfxCircle,MouseX(),MouseY()

TileImage handle,[x],[y],[frames]
Definicin:
Crea un mosaico en la pantalla con una imagen.

Descripcin de los Parmetros:

image = handel de la imagen x = coordenada x (opcional) y = coordenada y (opcional) frame = frame de la imagen (opcional)

Descripcin del Comando:

Si quieres crear un campo de estrellas o algn otro tipo de fondo hecho con mosaicos, este es TU comando. Todo lo que tienes que hacer es especificar el handle de la imagen (una imagen cargada con el comando LoadImage o LoadAnimImage). De forma opcional, puedes especificar una localizacin de comienzo as como el frame de la imagen.

Ejemplo:
Ver ImageBuffer

TileBlock image [,x,y,frame]

Definicin:
Crea un mosaico en la pantalla con una imagen ignorando las transparencias.

Descripcin de los Parmetros:

image = handel de la imagen x = coordenada x (opcional) y = coordenada y (opcional) frame = frame de la imagen (opcional)

Descripcin del Comando:

Similar a TileImage pero ignora las transparencias. salo para crear un mosaico en una parte o toda la pantalla usando una imagen.

120

Ayuda Blitz Basic

Ejemplo:
; Ejemplo TileBlock Graphics 800,600,16 ; Carga una imagen (su localizacin puede cambiar en tu ordenador, en el mo ni siquiera existe, jejeje) gfxBall=LoadImage("C:\Archivos de Programa\Blitz3D\samples\ball.bmp") ; Crea el mosaico sin transparencia TileBlock gfxBall ; Espera que pulses Esc While Not KeyHit(1) Wend

MaskImage handle,red,green,blue
Definicin:
Establece una mscara de imagen o color transparente.

Descripcin de los Parmetros:

handle=handle de la imagen red=valor rojo (0-255) green=valor verde (0-255) blue=valor azul (0-255)

Descripcin del Comando:

Blitz Basic asume que cuando cargas una imagen (usando LoadImage o LoadAnimImage) para dibujarla (usando DrawImage), quieres que el color negro (RGB 0,0,0) de tu imagen sea transparente. Llegar un momento en que quieras que algn otro color sea transparente. Este comando te permite hacerlo usando un valor RGB (yo uso Paint Shop Pro para saber los valores de rojo, verde y azul). Mira el ejemplo para comprender mejor este comandos.

Ejemplo:
Ver Ejemplo LoadAnimImage

HandleImage image,x,y
Definicin:
Establece una nueva localizacin de handle a una imagen existente.

Descripcin de los Parmetros:

image = handle de la imagen x = localizacin x del nuevo handle de imagen y = localizacin y del nuevo handle de imagen

Descripcin del Comando:

Cuando una imagen es cargada con LoadImage, el handle de la imagen (la localizacin en el interior de la imagen desde donde ser dibujada) est siempre por defecto en la esquina superior izquierda (coordenadas 0,0). Esto significa que si t dibujas una imagen de 50x50 pixels en las coordenadas 200,200 de la pantalla, la imagen comenzar a ser dibujada en 200,200 hasta acabar en 250,250. Este comando mueve el handle de la imagen de 0,0 a la coordenada especificada. Puedes recuperar las coordenadas del handle actual con los comandos ImageXHandle y ImageYHandle. Finalmente, puedes hacer que todas las imgenes se carguen automticamente con el handle en el punto medio usando el comando AutoMidHandle. Nota acerca del trmino 'handle'. Hay dos tipos de 'handles' que usaremos en estos documentos. Uno es la localizacin en el interior de una imagen (al que se hace referencia en este comando). El otro es un 'handle de archivo', una variable usada para mantener una imagen, sonido o fuente cargada con un comando. Mira LoadImage para ms informacin acerca de los handles de archivo. Mira tambin: MidHandle

Ejemplo:
;HandleImage Example Graphics 800,600,16 gfxPlayer=LoadImage("player.bmp") HandleImage gfxPlayer,20,20 DrawImage gfxPlayer,0,0 WaitKey

Ayuda Blitz Basic

121

MidHandle image
Definicin:
Establece el handle de imagen de la imagen especificada en el centro de la misma.

Descripcin de los Parmetros:

image = handle de archivo de la imagen

Descripcin del Comando:

Cuando una imagen es cargada con LoadImage, su handle (la localizacin dentro de la imagen desde donde la imagen es dibujada) siempre est por defecto en la esquina superior izquierda (coordenadas 0,0). Esto significa que si tu dibujas una imagen de 50x50 pixels en las coordenadas 200,200, la imagen comenzar a ser dibujada en las coordenadas 200,200 y se extender hasta 250,250. Este comando mueve le handle de imagen al punto medio exactamente de la imagen. Puedes establecer manualmente la localizacin del handle usando el comando HandleImage. Puedes obtener la posicin del handle usando los comandos ImageXHandle y ImageYHandle. Finalmente, puedes hacer que todas las imgenes carguen automticamente con el handle en el centro usando el comando AutoMidHandle. Nota acerca del trmino 'handle'. Hay dos tipos de 'handles' que veremos en estos documentos. Uno est localizado en el interior de una imagen (como vemos en este momento). El otro es un 'handle de fichero', una variable usada para manejar una imagen, un sonido o una fuente cargada con un comando. Mira LoadImage para ms informacin acerca de los 'handles de ficheros'.

Ejemplo:
; MidHandle/ImageXHandle()/ImageYHandle()/AutoMidHandle ; Initiate Graphics Mode Graphics 640,480,16 ; Set up the image file handle as a global Global gfxBall ; Load the image - you may need to change the location of the file gfxBall=LoadImage ("C:\Program Files\Blitz Basic\samples\ball.bmp") ; Until the user presses ESC key ... While Not KeyHit(1) Text 0,0,"Default Image Handle for gfxBall... Press ESC ..." Text 0,14,"X handle-" + ImageXHandle(gfxBall) ; Print the location of the image handle x location Text 0,28,"Y handle-" + ImageYHandle(gfxBall) ; Print the location of the image handle y location DrawImage gfxBall,200,200,0 ; draw the image at 200,200 Wend ; Clear the screen Cls ; Set the ball's handle to the center of the image MidHandle gfxBall ; Until the user presses ESC key ... show the new information While Not KeyHit(1) Text 0,0,"New Image Handle for gfxBall... Press ESC ..." Text 0,14,"X handle-" + ImageXHandle(gfxBall) Text 0,28,"Y handle-" + ImageYHandle(gfxBall) DrawImage gfxBall,200,200,0 Wend ; Makes all images load up with their handles in the center of the image AutoMidHandle True Cls ; Load the image again gfxBall=LoadImage ("C:\Program Files\Blitz Basic\samples\ball.bmp") ; Until the user presses ESC key ... show the new information While Not KeyHit(1) Text 0,0,"Automatic image handle of gfxBall... Press ESC ..." Text 0,14,"X handle-" + ImageXHandle(gfxBall) Text 0,28,"Y handle-" + ImageYHandle(gfxBall) DrawImage gfxBall,200,200,0 Wend

122

Ayuda Blitz Basic

AutoMidHandle true/false
Definicin:
Automticamente establece un handle de imagen en el centro de cada imagen cargada. Descripcin de los Parmetros: true = imgenes cargadas con el midhandle establecido por defecto false = imgenes cargan con el handle por defecto en 0,0

Descripcin del Comando:

Cuando una imagen es cargada con LoadImage, su handle (la localizacin dentro de la imagen desde donde la imagen es dibujada) siempre est por defecto en la esquina superior izquierda (coordenadas 0,0). Esto significa que si tu dibujas una imagen de 50x50 pixels en las coordenadas 200,200, la imagen comenzar a ser dibujada en las coordenadas 200,200 y se extender hasta 250,250. El comando MidHandle mueve el handle de la imagen al punto medio de la imagen. Mira este comando para ms informacin acerca del handle de imagen. Este comando elimina la necesidad de cambiar la posicin del handle en cada nueva imagen cargada, cambindolo automticamente cada vez que son cargadas. Nota acerca del trmino 'handle'. Hay dos tipos de 'handles' que veremos en estos documentos. Uno est localizado en el interior de una imagen (como vemos en este momento). El otro es un 'handle de fichero', una variable usada para manejar una imagen, un sonido o una fuente cargada con un comando. Mira LoadImage para ms informacin acerca de los 'handles de ficheros'.

Ejemplo:
Ver MidHandle

ScaleImage image,xscale#,yscale#
Definicin:
Escala una imagen usando porcentajes.

Descripcin de los Parmetros:

image = handle de la imagen xscale# = porcentaje de escala de la anchura yscale# = porcentaje de escala de la altura

Descripcin del Comando:

Usa este comando para reescalar una imagen a un nuevo tamao mediante porcentajes de coma flotante (1.0 = 100%, 2.0 = 200%, etc). Usando un valor negativo invertirs la imagen. Debes haber cargado la imagen con LoadImage o LoadAnimImage. NO sirve para escalar las imgenes en TIEMPO REAL!! Debes calcular el tamao de las imgenes antes de ejecutar tu programa o notars graves ralentizaciones.

Ejemplo:
; ScaleImage example ; Set Graphics Mode Graphics 800,600,16 ; Randomize the random seed SeedRnd MilliSecs() ; Load an image to tile (your location might vary) gfxBall=LoadImage("C:\Program Files\Blitz Basic\samples\ball.bmp") ; Scale it randomly from 50% to 150% both x and y ScaleImage gfxBall,Rnd(-2.0,2.0),Rnd(-2.0,2.0) ; Wait for ESC to hit While Not KeyHit(1) DrawImage gfxball,Rnd(800),Rnd(600) VWait Wend

ResizeImage image,width#,height#
Definicin:
Redimensiona una imagen.

Descripcin de los Parmetros:

image = handle de la imagen width# = nuevo ancho en pixels height# = nueva altura en pixels

Ayuda Blitz Basic

123

Descripcin del Comando:

Similar a ScaleImage, pero usa valores en pixels en vez de porcentajes. Usa este comando para redimensionar una imagen cargada previamente con LoadImage o LoadAnimImage. No se recomienda para escalar las imgenes en TIEMPO REAL, precalcula el tamao de tus imgenes antes de continuar la ejecucin de tu programa, o notars graves ralentizaciones.

Ejemplo:
; ResizeImage example ; Set Graphics Mode Graphics 800,600,16 ; Randomize the random seed SeedRnd MilliSecs() ; Load an image to tile (your location might vary) gfxBall=LoadImage("C:\Program Files\Blitz Basic\samples\ball.bmp") ; Size it randomly from 300 to -300 both x and y ResizeImage gfxBall,Rnd(-300,300),Rnd(-300,300) ; Wait for ESC to hit While Not KeyHit(1) DrawImage gfxball,Rnd(800),Rnd(600) VWait Wend

RotateImage image,value#
Definicin:
Rota la imagen en el sentido contrario de las agujas del reloj.

Descripcin de los Parmetros:

image = handle del archivo value# = nmero flotante entre 0 y 360 grados

Descripcin del Comando:

Este comando no es lo suficientemente rpido como para ser usado en rotaciones en tiempo real. Entonces, el propsito de este comando es rotar una imagen especificada un nmero concreto de grados. Este comando automticamente alisa los bordes de la imagen rotada, y las transparencias seran ignoradas. Para evitar esto, usa el comando TFormFilter. ste renderizar las imgenes rotadas con un filtro bilinear.

Ejemplo:
; RotateImage/TFormFilter Example ; Turn on graphics mode Graphics 640,480,16 ; Change the 0 to a 1 to see the difference ; between filter on and off. TFormFilter 0 ; Create new empty graphic to store our circle in gfxBox=CreateImage(50,50) ; Draw the box image ; Set drawing operations to point to our new empty graphic SetBuffer ImageBuffer(gfxBox) Color 255,0,0 ; Note the extra space between the box and the edge of the graphic Rect 10,10,30,30,1 SetBuffer FrontBuffer() While Not KeyHit(1) ; Make a copy of the image so we are always using a fresh one each time ; we rotate it. gfxTemp=CopyImage(gfxBox)

124 ; Rotate it a random value and draw it at a random location RotateImage gfxTemp,Rnd(360) DrawImage gfxTemp,Rnd(640),Rnd(480) Wend

Ayuda Blitz Basic

TFormImage image,a#,b#,c#,d#
Parmetros:
image - handle de la imagen a# - elemento 1,1 de una matriz de 2x2 b# - elemento 2,1 de una matriz de 2x2 c# - elemento 1,2 de una matriz de 2x2 d# - elemento 2,2 de una matriz de 2x2

Descripcin:
Transforma una imagen basada en una matriz de 2x2. El nico uso real para este comando que no est disponible va ScaleImage o RotateImage es que puedes usarlo para cortar una imagen.

TFormFilter enable
Definicin:
Activa el filtro bilinear en imgenes retorcidas.

Descripcin de los Parmetros:

enable = 0 para desactivar el filtro; 1 para activarlo

Descripcin del Comando:

Este comando activa/desactiva el filtro bilinear en imgenes que son retorcidas (alteradas) por comandos como TFormImage y RotateImage. Este filtro permite a este tipo de grficos tener suavizado, las aristas ms alisadas. Esto tambin ralentiza las operaciones. El filtro bilinearpuede tambin crear aristas no transparentes. Experimenta para obtener mejores resultados. Prueba cambiando el ejemplo para ver la diferencia.

Ejemplo:
Ver Ejemplo RotateImage

ImageWidth (image handle)

Definicin:
Devuelve el ancho de la imagen especificada, en pixels.

Descripcin de los Parmetros:

image handle = handle de la imagen

Descripcin del Comando:

Usa este comando con ImageHeight para saber el tamao de la imagen (usando el handle obtenido cuando la imagen fue cargada con LoadImage) en pixels.

image1 = handle de la primera imagen x1 = localizacin x de la primera imagen y1 = localizacin y de la primera imagen image2 = handle de la segunda imagen x2 = localizacin x de la segunda imagen y2 = localizacin y de la segunda imagen

126

Ayuda Blitz Basic

Descripcin del Comando:

ste es muy rpido, te permitir saber si una de las dos imgenes est superpuesta a la otra. No se tienen en cuenta los pixels transparentes (mira ImagesCollide). Como todo sistema de deteccin de colisin en Blitz, necesitars los handles de las dos imgenes y sus coordenadas X e Y en el momento en que ocurrir la colisin. Usa este comando con imgenes con formas muy regulares, no con formas extraas. El ejemplo usa grficos que son mucho ms pequeos que su contenedor para mostrarte la imprecisin de este comando (si no se usa adecuadamente). El ejemplo de ImagesCollide es idntico a este (y muestra como trabaja la colisin por pixel perfecta).

Ejemplo:
; ImagesOverlap Example ; Turn on graphics mode Graphics 640,480,16 ; Create two new empty graphics to store our circle and box in gfxBox=CreateImage(50,50) gfxCircle=CreateImage(50,50) ; Draw the box image first ; Set drawing operations to point to our new empty graphic SetBuffer ImageBuffer(gfxBox) ; Change drawing color to blue Color 0,0,255 ;Draw our box (note that it has a 10 pixel space around it) Rect 10,10,30,30,1 ; Repeat for the circle graphic SetBuffer ImageBuffer(gfxCircle) Color 255,0,0 ; Note the extra space between the circle and the edge of the graphic Oval 10,10,30,30,1 ; Let's not forget to put the drawing buffer back! SetBuffer BackBuffer() ; Locate our box to a random, visible screen location boxX=Rnd(50,610) boxY=Rnd(50,430) ; Repeat the loop until we've had a collision Repeat ; Attach our mouse to the circle to move it circleX=MouseX() circleY=MouseY() ; Standard double buffer technique; clear screen first Cls ; Draw our objects at the designated location DrawImage gfxBox,boxX,boxY DrawImage gfxCircle,circleX,circleY ; Standard double buffer technique; flip after all drawing is done Flip ; We test the locations of our box and circle to see if they have overlapped Until ImagesOverlap (gfxBox,boxX,boxY,gfxCircle,circleX,circleY) ; Loop is over, we must've collided! Text 0,0, "WE'VE HAD A COLLISION! PRESS A MOUSE BUTTON" ; Can't see the text until we flip .. Flip ; Wait for a mouse click WaitMouse() ; End our graphics mode EndGraphics

ImagesCollide (image1,x1,y1,frame1,image2,x2,y2,frame2)
Definicin:
Comprueba si dos imgenes han colisionado.

Ayuda Blitz Basic

127

Descripcin de los Parmetros:

image1 = handle de la primera imagen x1 = localizacin x de la primera imagen y1 = localizacin y de la primera imagen frame1 = frame de la primera imagen (opcional) image2 = handle de la segunda imagen x2 = localizacin x de la segunda imagen y2 = localizacin y de la segunda imagen frame2 = frame de la segunda imagen (opcional)

Descripcin del Comando:

Este es EL COMANDO para obtener colisiones por pixel perfectas entre imgenes. No tendr en cuenta los pixels transparentes durante la comprobacin (bsicamente, slo la 'chicha' de la imagen producir la colisin). Esto lo hace perfecto para la mayora de las situaciones donde tengas figuras raras. El comando ImagesOverlap es MUY MUY rpido, sin embargo, slo puedes determinar si LGUNA de las dos imgenes se ha superpuesto (esto incluye los pixels transparentes). Este mtodo trabaja si t tienes grficos que estn cubiertos completamente y no necesitas tanta precisin. Como todo sistema de deteccin de colisin en Blitz, necesitars los handles de las dos imgenes y sus coordenadas X e Y en el momento en que ocurrir la colisin. El ejemplo usa grficos que son mucho ms pequeos que su contenedor para mostrarte la precisin de este comando. El ejemplo de ImagesOverlap es idntico a este (y muestra la imprecisin del mtodo del 'overlapping').

Ejemplo:
; ImagesCollide Example ; Turn on graphics mode Graphics 640,480,16 ; Create two new empty graphics to store our circle and box in gfxBox=CreateImage(50,50) gfxCircle=CreateImage(50,50) ; Draw the box image first ; Set drawing operations to point to our new empty graphic SetBuffer ImageBuffer(gfxBox) ; Change drawing color to blue Color 0,0,255 ;Draw our box (note that it has a 10 pixel space around it) Rect 10,10,30,30,1 ; Repeat for the circle graphic SetBuffer ImageBuffer(gfxCircle) Color 255,0,0 ; Note the extra space between the circle and the edge of the graphic Oval 10,10,30,30,1 ; Let's not forget to put the drawing buffer back! SetBuffer BackBuffer() ; Locate our box to a random, visible screen location boxX=Rnd(50,610) boxY=Rnd(50,430) ; Repeat the loop until we've had a collision Repeat ; Attach our mouse to the circle to move it circleX=MouseX() circleY=MouseY() ; Standard double buffer technique; clear screen first Cls ; Draw our objects at the designated location DrawImage gfxBox,boxX,boxY DrawImage gfxCircle,circleX,circleY ; Standard double buffer technique; flip after all drawing is done Flip ; We test the locations of our box and circle to see if they have pixel collided Until ImagesCollide (gfxBox,boxX,boxY,0,gfxCircle,circleX,circleY,0) ; Loop is over, we must've collided!

128 Text 0,0, "WE'VE HAD A COLLISION! PRESS A MOUSE BUTTON" ; Can't see the text until we flip .. Flip ; Wait for a mouse click WaitMouse() ; End our graphics mode EndGraphics

Ayuda Blitz Basic

RectsOverlap (rect1 X,rect1 Y,rect1 Width,rect1 Height,rect2 X,rect2 Y,rect2 Width,rect2 Height)
Definicin:
Comprueba si dos reas rectangulares se estn superponiendo.

Descripcin de los Parmetros:

rect1 X = posicin x del rectngulo 1 rect1 Y = posicin y del rectngulo 1 rect1 Width = ancho del rectngulo 1 rect1 Height = alto del rectngulo 1 rect2 X = posicin x del rectngulo 2 rect2 Y = posicin y del rectngulo 2 rect2 Width = ancho del rectngulo 2 rect2 Height = alto del rectngulo 2

Descripcin del Comando:

Descripcin de los Parmetros:

milliseconds = la cantidad de milsimas de segundo que se parar el programa. 1000=1 segundo

Descripcin del Comando:

Este comando para toda la ejecucin del programa durante el tiempo especificado. TODA ejecucin parar.

132

Usa este comando en conjuncin con el comando WaitTimer para controlar la velocidad de un programa en ejecucin (fps).

Ejemplo:
; Create the timer to track speed frameTimer=CreateTimer(60) ; Your main screen draw loop While Not KeyHit(1) WaitTimer(frameTimer) ; Pause until the timer reaches 60 Cls ; Draw your screen stuff Flip Wend

Ayuda Blitz Basic

133

FreeTimer (timer_variable)
Definicin:
Destruye el timer especificado y libera su memoria.

Descripcin de los Parmetros:

timer = handle del timer

Descripcin del Comando:

Este comando destruir un timer creado con el comando CreateTimer y libera la memoria que estuviera usando.

WaitTimer (timer_variable)
Definicin:
Para la ejecucin del programa hasta que el tiempo especificado haya transcurrido.

Descripcin de los Parmetros:

timer = handle del timeer obtrenido cuando fue creado con el comando CreateTimer

Descripcin del Comando:

salo junto con el comando CreateTimer. Este comando parar la ejecucin del programa hasta que el tiemer alcance su valor. Esto es til para controlar la velocidad de tus programas. Echa un vistazo al comando CreateTime para entender esto mejor.

Ejemplo:
; Crea el timer para controlar la velocidad frameTimer=CreateTimer(60) ; Bucle principal de dibujo While Not KeyHit(1) WaitTimer(frameTimer) ; Para hasta que el timer alcance 60 Cls Flip Wend

WINDOWS/DEBUG CallDLL( nombre_dll$, nombre_proc$[,en_banco,fuera_banco] )

Parmetros:
nombre_dl$ - nombre de la dll nombre_proc$ - nombre del procedimiento en_banco (opcional) - handle del banco que ha sido creado en Blitz para un procedimiento de DLL fuera_banco (opcional) - handle del banco que ha sido creado en un procedimiento de DLL para Blitz

Descripcin:
Llama a un procedimiento especfico de la DLL especificada y devuelve el valor entero devuelto por el procedimiento de la DLL. La DLL es llamada a travs de punteros y tamaos de bancos de memoria. El prototipo de una funcin de DLL debera parecerse algo a este ejemplo (Visual C++):

134 extern "C"{ _declspec(dllexport) int _cdecl my_dll_func( const void *in,int in_size,void *out,int out_sz ); }

Ayuda Blitz Basic

El bit 'extern "C"' previene el C++ 'destroza-nombres' y el bit _cdecl previene nombre decoracin. Podras llamar a esta funcin usando algo parecido a esto: in_bank=CreateBank(...) out_bank=CreateBank(...) ;poke input parameters into in_bank result=CallDLL( "mydll","my_dll_func",bank1,bank2 ) ;peek output results from out_bank

SystemProperty (property$)
Parmetros:
property$ - propiedad del sistema que quieras conocer

Descripcin:
SystemProperty () devuelve la localizacin del directorio de sistema, que puede ser diferentes en cada ordenador. Nota: no es una buena idea jugar en el directorio Windows o System de un usuario.

Parmetros vlidos son:

"tempdir" - Directorio de temporales "systemdir" - Directorio System "windowsdir" - Directorio Windows "appdir" - Directorio de Archivos de Programa

Ejemplo:
Print Print Print Print "Localizacin "Localizacin "Localizacin "Localizacin del del del del directorio directorio directorio directorio System: " + SystemProperty ("systemdir") Windows: " + SystemProperty ("windowsdir") de temporales: " + SystemProperty ("tempdir") de Archivos de Programa: " + SystemProperty ("appdir")

CommandLine$()
Definicin:
Lee los parmetros pasados en la lnea de comandos en tiempo de ejecucin.

Descripcin de los Parmetros:

Ninguno.

Descripcin del Comando:

Si ests escribiendo una aplicacin o un juego que permita empezar con parmetros especiales en la lnea de comandos, puedes usar este comando para recuperar esos parmetros. Por ejemplo, quieres comenzar el programa con una variable de debug establecida para poder depurar durante la ejecucin. As, puedes ofrecer la posibilidad de lanzar el ejecutable con una opcin /debug. Si se ejecuta con el parmetro puedes activar un flag dentro del juego para saberlo. Para simular la lnea de comandos en el editor, selecciona PROGRAMA->LNEA DE COMANDOS DEL PROGRAMA desde el men desplegable e introduce los parmetros que quieras. Mira el ejemplo.

Ejemplo:
; CommandLine$() Example ; Be sure to use PROGRAM->PROGRAM COMMAND LINE from the ; pull down and put /debug in there to test with. a$=CommandLine$() If a$="/debug" Then Print "Debug mode is on!" debug=1 Else Print "No debugging activated." debug=0 End If

Ayuda Blitz Basic

135

ShowPointer
Parmetros:
Ninguno.

Descripcin:
ShowPointer se usa en modos de ventana, y simplemente muestra el puntero del ratn tras haber sido escondido (con HidePointer). No tiene ningn efecto en modos a pantalla completa.

Ejemplo:
Graphics 640, 480, 0, 2 HidePointer Print "Move pointer over window and press a key..." WaitKey ShowPointer Delay 1000

HidePointer
Parmetros:
Ninguno.

Descripcin:
HidePointer se usa cuando se est en modo ventana y simplemente oculta el puntero de Windows cuando se mueve por la ventana del juego. Puedes volver a mostrarlo con ShowPointer. No tiene efecto en modos a pantalla completa.

Example (using ShowPointer):

Graphics 640, 480, 0, 2 HidePointer Print "Move pointer over window and press a key..." WaitKey ShowPointer Delay 1000

AppTitle ttulo$[,mensaje_final$]
Definicin:
Establece el ttulo de la barra del programa.

Descripcin de los Parmetros:

ttulo$ - el texto que aparecer en la barra de ttulo de la ventana del programa mensaje_final$ (opcional) - el texto que ser mostrado en un cuadro de dilogo con las opciones OK/CANCEL cuando un usuario hace click en el botn de cerrar. Si no se especifica nada, el cuadro de dilogo no ser mostrado y el programa se cerrar inmediatamente.

Descripcin del Comando:

Te permite establecer el texto de la barra de ttulo del programa, y el cuadro de dilogo "est seguro de querer cerrar el programa?".

Ejemplo:
; Set the title bar AppTitle "Super Invaders V1.0"

Si ests ejecutando el programa en modo debug (depuracin), este comando te permite parar la ejecucin del programa y devolverte al editor donde puedes avanzar lnea a lnea por tu cdigo, ver las vaiables, etc.

Ejemplo:
; Halt the program and go to the editor/debugger Stop

Ayuda Blitz Basic

137

End
Definicin:
Para la ejecucin del programa y sale de l.

Descripcin de los Parmetros:

Ninguno.

Descripcin del Comando:

Usa este comando para parar la ejecucin de tu programa. Sers devuelto al editor si lo estabas ejecutando desde all o el programa saldr completamente si ests usando un EXE compilado.

Ejemplo:
; If the game is over, then quit if gameOver=1 then End

3D - Categoras
GLOBAL Graphics3D
Parmetros:
ancho ancho de la resolucin de pantalla alto alto de la resolucin de pantalla profundidad (opcional) profundidad de color de la pantalla. Por defecto es el color de mxima profundidad disponible. modo (opcional) modo de pantalla. Por defecto es 0. 0: en ventana (si es posible) en el modo de depuracin, pantalla completa en modo de no depuracin 1: pantalla completa siempre 2. en ventana siempre 3: en ventana/escalada siempre

(ancho,alto[,profundidad,modo])

Descripcin:
Establece el modo de grficos 3D. Este comando debe ejecutarse antes de cualquier otro comando 3D, de otro modo los programas podran dar error. El ancho y el alto establecen la resolucin de la pantalla y los valores ms comunes son 640,480 y 800,600. La resolucin debe ser compatible con la tarjeta 3D y con el monitor que se estn usando. La profundidad establece el modo de color de la pantalla. Si se omite este valor o se establece a 0, se usar la profundidad de color ms alta que haya disponible. Otros valores disponibles normalmente son 16, 24 y 32. El modo de color 16-bit muestra el nmero mnimo de colores, 65536. Los modos de color 24-bit y 32-bit muestran ms de 16 millones de colores y suele dar como resultado una mejor calidad de la imagen, aunque puede dar como resultado programas ms lentos que en 16-bit.

Ejemplo:
; Graphics3D Example ; -----------------; Sets 3D graphics mode Graphics3D 640,480,16,0 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() cone=CreateCone( 32 ) PositionEntity cone,0,0,5 While Not KeyDown( 1 ) RenderWorld Flip Wend End

138

Ayuda Blitz Basic

Dither enable
Parmetros:
enable - true para activar el dithering, false para desactivarlo. Por defecto es true.

Descripcin:
Activa o desactiva el dithering del hardware. El dithering del hardware se usa cuando ejecutamos juegos en modo de color de 16-bit. Debido al hecho de que el modo 16-bit ofrece menos colores de los que el ojo humano distingue, se pueden notar bandas separadas de colores en objetos sombreados. Sin embargo, el dithering del hardware tendr efecto sobre toda la pantalla para dar la impresin de que se estn usando ms colores de los que realmente se usan, y generalmente da mejor impresin. Debido al hecho de que los modos 24-bit y 32-bit ofrecen ms colores de los que el ojo humano puede distinguir, el dithering del hardware se hace bastante ms redundante en estos modos.

Ejemplo:
; Dither Example ; -------------Graphics3D 640,480,16 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() ; Rotate light so that it creates maximum shading effect on sphere RotateEntity light,90,0,0 sphere=CreateSphere( 32 ) PositionEntity sphere,0,0,2 While Not KeyDown( 1 ) ; Toggle dither enable value between true and false when spacebar is pressed If KeyHit( 57 )=True Then enable=1-enable ; Enable/disable hardware dithering Dither enable RenderWorld Text 0,0,"Press spacebar to toggle between Dither True/False" If enable=False Then Text 0,20,"Dither False" Else Text 0,20,"Dither True" Flip Wend End

WBuffer enable
Parmetros:
enable - True para activar el render w-buffering, False para desactivarlo.Por defecto es True para modos de color de 16-bit, y False para 24-bit y 32-bit.

Descripcin:
Activa o desactiva el w-buffering. W-buffering es una tcnica usada para dibujar objetos 3D segn su profundidad por ejemplo, primero los que estn ms lejos de la cmara, despus los que estn ms cerca de la cmara, etc. Normalmente, el z-buffering se usa como estrategia, pero el z-buffer puede ser ligeramente impreciso en modos de 16-bit, por lo que el nivel de precisin es menos que en modos de color de 24bit o 32-bit. Esto significa que en algunas situaciones, los objetos aparecern superponindose unos a otros cuando no debera ocurrir. Para compensar esto, puedes usar el w-buffering. ste es ligeramente ms preciso que el z-buffering, aunque en algunas ocasiones puede ser menos compatible que el z-buffering.

Antialias enable
Parmetros:
enable - true para activar el antialiasing a pantalla completa, false para desactivarlo. Por defecto es false.

Ayuda Blitz Basic

139

Descripcin:
Activa o desactiva el antialiasing a pantalla completa. Antialiasing a pantalla completa es una tcnica usada para suavizar la pantalla completa, para que las lneas angulosas sean menos notables. Algunas tarjetas 3D tienen soporte incorporado para el antialiasing a pantalla completa, que permitira activar el efecto sin restar velocidad. Sin embargo, para las tarjetas que no soportan el antialiasing a pantalla completa, activar el efecto podra causar una gran lentitud.

Ejemplo:
; AntiAlias Example ; ----------------Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() RotateEntity light,90,0,0 sphere=CreateSphere() PositionEntity sphere,0,0,2 While Not KeyDown( 1 ) ; Toggle antialias enable value between true and false when spacebar is pressed If KeyHit( 57 )=True Then enable=1-enable ; Enable/disable antialiasing AntiAlias enable RenderWorld Text 0,0,"Press spacebar to toggle between AntiAlias True/False" If enable=False Then Text 0,20,"AntiAlias False" Else Text 0,20,"AntiAlias True" Flip Wend End

Wireframe enable
Parmetros:
enable - True para activar el render en wireframe, False para desactivarlo. Por defecto es False.

Descripcin:
Activa o desactiva el render wireframe. Esto mostrar las aristas de cada polgono de la pantalla, con las reas no sombreadas. Este modo suele usarse slo para depurar, porque el soporte del controlador es desigual. Por la misma razn no se ofrece soporte para el render wireframe para los entes de polgono individual.

Ejemplo:
; Ejemplo Wireframe ; ----------------Graphics3D 640,480,16 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() RotateEntity light,90,0,0 sphere=CreateSphere( 32 ) PositionEntity sphere,0,0,2 While Not KeyDown( 1 ) ; Toggle wireframe enable value between true and false when spacebar is pressed

140 If KeyHit( 57 )=True Then enable=1-enable ; Enable/disable wireframe rendering WireFrame enable RenderWorld Text 0,0,"Press spacebar to toggle between Wireframe True/False" If enable=True Then Text 0,20,"Wireframe True" Else Text 0,20,"Wireframe False" Flip Wend End

Ayuda Blitz Basic

HWMultiTex activa
Parmetros:
activa - true para activar la multitextura del hardware, false para desactivarlo. Por defecto es true.

Descripcin:
Activa o desactiva la multitextura del hardware. La multitextura es una tcnica usada para mostrar ms de una textura a la vez en un objeto. A veces, el hardware 3D tiene soporte para esto, por lo que usar dos o ms texturas por objeto no causar ms lentitud que usar slo una. Aunque, algunas tarjetas dan problemas con la multitextura del hardware, para estas situaciones tienes la opcin de deshabilitarlo. Cuando no se est usando la textura de hardware, Blitz3D usar su propia tcnica de software, con lo que involucra objetos duplicados que tienen una textura cada uno.

AmbientLight rojo#,verde#,azul#
Parmetros:
rojo# - valor rojo de la luz ambiental verde# - valor verde de la luz ambiental azul# - valor azul de la luz ambiental

Descripcin:
Establece el color de la luz ambiental. Los valores verde, rojo y azul deberan estar en el rango 0-255. El color de la luz ambiental por defecto es 255,255,255. La luz ambiental es el origen de una luz que afecta a todos los puntos de un objeto 3D por igual. Por tanto, solo con una luz ambiental, todos los objetos 3D aparecern absolutamente, no habr sombras. La luz ambiental se usa para proporcionar un nivel de luz, antes de aadir otras luces que proporcionen un efecto de luz realista. Un nivel de luz ambiental de 0,0,0 dar como resultado un ambiente sin luz.

Ejemplo:
; AmbientLight Example ; -------------------Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera() sphere=CreateSphere( 32 ) PositionEntity sphere,-2,0,5 cone=CreateCone( 32 ) PositionEntity cone,2,0,5 ; Set initial ambient light colour values red#=127 green#=127 blue#=127 While Not KeyDown( 1 ) ; Change red, green, blue values depending on key pressed If KeyDown( 2 )=True And red#>0 Then red#=red#-1

Ayuda Blitz Basic If If If If If KeyDown( KeyDown( KeyDown( KeyDown( KeyDown( 3 4 5 6 7 )=True )=True )=True )=True )=True And And And And And red#<255 Then red#=red#+1 green#>0 Then green#=green#-1 green#<255 Then green#=green#+1 blue#>0 Then blue#=blue#-1 blue#<255 Then blue#=blue#+1

141

; Set ambient light using red, green, blue values AmbientLight red#,green#,blue# RenderWorld Text Text Text Text Flip Wend End 0,0,"Press keys 1-6 to change AmbientLight red#,green#,blue# values 0,20,"Ambient Red: "+red# 0,40,"Ambient Green: "+green# 0,60,"Ambient Blue: "+blue#

ClearCollisions
Parmetros:
Ninguno.

Descripcin:
Limpia la lista de informacin de colisiones. Siempre que se utiliza el comando Collisions para activar las colisiones entre dos tipos de ente diferentes, la informacin se aade a la lista de colisiones. Este comando limpia esa lista, por tanto no se detectar ninguna colisin hasta que se use de nuevo el comando Collisions. El comando no limpiar la informacin de colisin del ente. Por ejemplo, el radio del ente, tipo, etc.

Ejemplo:
; ClearCollisions Example ; ----------------------Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() sphere=CreateSphere( 32 ) PositionEntity sphere,-2,0,5 cone=CreateCone( 32 ) EntityType cone,type_cone PositionEntity cone,2,0,5 ; Set collision type values type_sphere=1 type_cone=2 ; Set up sphere collision data EntityRadius sphere,1 EntityType sphere,type_sphere ; Set up cone collision data EntityType cone,type_cone ; Enable collisions between type_sphere and type_cone, with sphere->polygon method and slide response Collisions type_sphere,type_cone,2,2 While Not KeyDown( 1 ) x#=0 y#=0 z#=0

142 If If If If If If KeyDown( KeyDown( KeyDown( KeyDown( KeyDown( KeyDown( 203 )=True Then x#=-0.1 205 )=True Then x#=0.1 208 )=True Then y#=-0.1 200 )=True Then y#=0.1 44 )=True Then z#=-0.1 30 )=True Then z#=0.1

Ayuda Blitz Basic

MoveEntity sphere,x#,y#,z# ; If spacebar pressed then clear collisions If KeyHit( 57 )=True Then ClearCollisions ; Perform collision checking UpdateWorld RenderWorld Text 0,0,"Use cursor/A/Z keys to move sphere" Text 0,20,"Press spacebar to use ClearCollisions command" Flip Wend End

Collisions orig_tipo,dest_tipo,mtodo,respuesta
Parmetros:
orig_tipo tipo de ente para comprobar si colisiona. dest_tipo tipo de ente con el que colisiona. mtodo mtodo de deteccin de colisin. 1: colisin de esfera a esfera 2: colisin de esfera a polgono 3: colisin de esfera a caja respuesta lo que hace el ente de orig_tipo cuando ocurre la colisin. 1: parar 2: deslizarse1 deslizamiento completo en la colisin 3: deslizarse2 desliza al ente hacia abajo en una cuesta

Descripcin:
Activa las colisiones entre dos tipos distintos de entes. Los tipos de ente son simplemente nmeros que se asignan a un ente usando EntityType. Blitz utiliza los tipos de entes para comprobar las colisiones entre todos los entes que tienen esos tipos de ente. Blitz tiene varias formas de comprobar las colisiones, como demuestra el parmetro mtodo. Sin embargo, la colisin comprobada es siempre la de una esfera contra algo. Para que Blitz pueda saber el tamao del ente de origen, se debe asignar primero un radio del ente al ente de origen utilizando EntityRadius. En el caso de detectar una colisin teniendo seleccionado el mtodo 1 (esfera a esfera), los entes de destino implicados en la colisin debern tener tambin asignado un EntityRadius. En el caso de estar seleccionado el mtodo 3 (esfera a caja), los entes de destino necesitarn tener asignado un EntityBox. El mtodo 2 (esfera a polgono) no requiere que el ente de destino tenga nada asignado. Blitz no solo comprueba las colisiones, sino que tambin acta sobre ellas cuando las detecta, como demuestra el parmetro respuesta. Hay tres opciones cuando se da esta situacin. Se puede escoger entre hacer al ente detenerse, deslizarse o simplemente hacer que se deslice cuesta abajo. Todas las colisiones y sus respuestas se ejecutan cuando se llama a UpdateWorld. Finalmente, cada vez que se utiliza el comando Collision, la informacin de la colisin se aade a una lista de informacin de colisiones. Esta puede borrarse utilizando el comando ClearCollisions.

Ejemplo:
; Collisions Example ; -----------------Graphics3D 640,480 SetBuffer BackBuffer() ; Set collision type values type_character=1 type_scenery=2 camera=CreateCamera() RotateEntity camera,45,0,0

Ayuda Blitz Basic PositionEntity camera,0,15,-10 light=CreateLight() RotateEntity light,45,0,0 ; Create sphere 'character' sphere=CreateSphere( 32 ) EntityRadius sphere,1 EntityType sphere,type_character PositionEntity sphere,0,7,0 ; Create cube 'scenery' cube=CreateCube() EntityRadius cube,1 EntityType cube,type_scenery PositionEntity cube,0,-5,0 EntityColor cube,127,0,0 ScaleEntity cube,10,10,10 ; Create cylinder 'scenery' cylinder=CreateCylinder( 32 ) ScaleEntity cylinder,2,2,2 EntityColor cylinder,255,0,0 EntityType cylinder,type_scenery PositionEntity cylinder,-4,7,-4 ; Create cone 'scenery' cone=CreateCone( 32 ) ScaleEntity cone,2,2,2 EntityColor cone,255,0,0 EntityType cone,type_scenery PositionEntity cone,4,7,-4 ; Create prism 'scenery' prism=CreateCylinder( 3 ) ScaleEntity prism,2,2,2 EntityColor prism,255,0,0 EntityType prism,type_scenery PositionEntity prism,-4,7,4 RotateEntity prism,0,180,0 ; Create pyramid 'scenery' pyramid=CreateCone( 4 ) ScaleEntity pyramid,2,2,2 EntityColor pyramid,255,0,0 EntityType pyramid,type_scenery RotateEntity pyramid,0,45,0 PositionEntity pyramid,4,7,4 ; Set collision method and response values method=2 response=2 method_info$="sphere-to-polygon" response_info$="slide1" While Not KeyDown( 1 ) x#=0 y#=0 z#=0 If If If If KeyDown( KeyDown( KeyDown( KeyDown( 203 205 208 200 )=True )=True )=True )=True Then Then Then Then x#=-0.1 x#=0.1 z#=-0.1 z#=0.1

143

MoveEntity sphere,x#,y#,z# MoveEntity sphere,0,-0.02,0

144 ; Change collision method If KeyHit(50)=True method=method+1 If method=4 Then method=1 If method=1 Then method_info$="sphere-to-sphere" If method=2 Then method_info$="sphere-to-polygon" If method=3 Then method_info$="sphere-to-box" EndIf ; Change collision response If KeyHit(19)=True response=response+1 If response=4 Then response=1 If response=1 Then response_info$="stop" If response=2 Then response_info$="slide1" If response=3 Then response_info$="slide2" EndIf ; Enable Collions between type_character and type_scenery Collisions type_character,type_scenery,method,response ; Perform collision checking UpdateWorld RenderWorld Text Text Text Text Flip Wend End 0,0,"Use cursor keys to move sphere" 0,20,"Press M to change collision Method (currently: "+method_info$+")" 0,40,"Press R to change collision Response (currently: "+response_info$+")" 0,60,"Collisions type_character,type_scenery,"+method+","+response

Ayuda Blitz Basic

UpdateWorld [veloc_anim#]
Parameters: veloc_anim# (opcional) - un control general de la velocidad de las animaciones. Por defecto vale 1. Descripcin:
Anima todos los entes del mundo, y realiza la comprobacin de colisiones. El parmetro opcional veloc_anim# permite afectar a la velocidad de las animaciones de todos los entes a la vez. Un valor de 1 animar los entes a su velocidad de animacin normal, un valor de 2 animar los entes al doble de su velocidad normal de animacin, y as sucesivamente. Para mejores resultados usa este comando una vez en el bucle principal, justo antes de RenderWorld.

CaptureWorld
Parmetros:
Ninguno.

Descripcin:
Hace una captura de la posicin y orientacin de cada uno de los entes del mundo. Esta captura puede usarse luego con RenderWorld para renderizar los entes en el punto entre sus posiciones capturadas y sus posiciones actuales. Ver RenderWorld para saber ms sobre cmo y porqu se hace.

RenderWorld [tween#]
Parmetros:
tween# - por defecto es 1.

Ayuda Blitz Basic

145

Descripcin:
Renderiza todos los entes en un mundo. El parmetro opcional tween puede usarse para renderizar todos los entes en un punto cualquiera entre sus posiciones capturadas y su posicin actual. Un valor tween de 0 renderizar los entes a su posicin capturada. Un valor de 1 renderizar los entes a su posicion actual. Pueden usarse otros valores para la interpolacin. Por defecto es 1. Tweening es una tcnica usada para permitir actualizar la lgica los juegos un nmero fijo de veces, por ejemplo, 30 mientras interpolamos con Blitz3D en estos juegos los actualiza tantas frames por Segundo como puede, por ejemplo 60+, con cada frame diferente al final. Esto resulta en un juego en el que solamente tiene que tener su lgica de juego actualizada a la mitad de sus renderizados por Segundo, liberando tiempo de CPU, mientras al mismo tiempo el juego se ejecuta de la mejor manera posible en la mquina de cada uno. Renderizar con tweening es una tcnica bastante avanzada, y no es necesaria usarla, por lo tanto no te preocupes si no lo entiendes demasiado. Mira la demo del castillo incluida en la carpeta mak (nickname de Mark Sibly, autor de Blitz3D) en la seccin de ejemplos de Blitz3D para una demostracin del renderizado con tweening.

ClearWorld [entes][,pinceles][,texturas]
Parmetros:
Entes true para borrar los entes, false para no hacerlo Pinceles true para borrar los pinceles, false para no hacerlo Texturas true para borrar las texturas, false para no hacerlo

Descripcin:
Borra todos los entes, pinceles y/o texturas de un mundo. Se usa cuando el nivel de un juego se ha terminado y se desea borrar todo para prepararse para cargar nuevos entes/pinceles/texturas sin tener que borrar cada ente/pincel/textura individualmente. Ver tambin: FreeEntity, FreeBrush, FreeTexture.

LoaderMatrix extensin_archivo$,xx#,xy#,xz#,yx#,yy#,yz#,zx#,zy#,zz#
Parmetros:
Extension_archivo$ - extensin del archivo 3d, por ejemplo ".x",".3ds" xx# - elemento 1,1 de una matriz de 3x3 xy# - elemento 2,1 de una matriz de 3x3 xz# - elemento 3,1 de una matriz de 3x3 yx# - elemento 1,2 de una matriz de 3x3 yy# - elemento 2,2 de una matriz de 3x3 yz# - elemento 3,2 de una matriz de 3x3 zx# - elemento 1,3 de una matriz de 3x3 zy# - elemento 2,3 de una matriz de 3x3 zz# - elemento 3,3 de una matriz de 3x3

Descripcin:
Establece una matriz de archivos 3d cargados con la extensin de archivo especificada. Puede usarse para cambiar el sistema de coordenadas cuando se cargan. Por defecto, se usa el siguiente cargador de matrices: LoaderMatrix "x",1,0,0,0,1,0,0,0,1 ; sin cambios en el sistema de coordenadas LoaderMatrix "3ds",1,0,0,0,0,1,0,1,0 ; intercambia los ejes y/z Puedes usar LoaderMatrix para invertir mallas/animaciones si es necesario, por ejemplo: LoaderMatrix "x",-1,0,0,0,1,0,0,0,1 ; invierte las coordenadas x para los archivos ".x" LoaderMatrix "3ds",-1,0,0,0,0,-1,0,1,0 ; intercambia y/z, anula x/z para archivos ".3ds"

TrisRendered()
Parmetros:
Ninguno.

Descripcin:
Devuelve el nmero de tringulos renderizados durante el ltimo RenderWorld. til para depurar - para ver si ests mostrando muchos o pocos polgonos.

Ejemplo:
; TrisRendered Example ; -------------------Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera() PositionEntity camera,0,0,-2 light=CreateLight() RotateEntity light,90,0,0

146 segs=Rand( 2,16 ) sphere=CreateSphere(segs) While Not KeyDown( 1 ) If KeyHit( 57 )=True FreeEntity sphere segs=Rand( 2,16 ) sphere=CreateSphere( segs ) EndIf RenderWorld Text 0,0,"Press space to create a sphere with a random segments value" ; Display triangles rendered Text 0,20,"Triangles Rendered: "+TrisRendered() Flip Wend End

Ayuda Blitz Basic

TEXTURA CreateTexture ( ancho,alto[,flags][,frames] )

Parmetros:
ancho ancho de la textura alto alto de la textura flags (opcional) flag de la textura 1: Color 2: Alfa 4: Oculta 8: Mipmapped (mapa de bajo detalle) 16: Clamp U 32: Clamp V 64: mapa de reflexin esfrica frames (opcional) nmero de frames que tendr la textura

Descripcin:
Crea una textura y devuelve su puntero. El ancho y el alto son el tamao de la textura. Nota que el tamao actual de la textura puede ser diferente del ancho y alto requeridos, ya que diferentes tipos de hardware 3D soportan diferentes tamaos de texturas. El parmetro opcional flags permite aplicar ciertos efectos a la textura. Los pueden aadirse para combinar dos o ms efectos, por ejemplo 3 (1+2) = textura con color y mapas alfa. Aqu tienes algunas descripciones de los flags: 1: Color mapa de color, lo que ves es lo que obtienes. 2: Alfa mapa de alfa. Si una imagen contiene un mapa de alfa, este se usar para hacer ciertas reas de la textura transparente. A parte de esto, el mapa de color podr usarse como un mapa alfa. Con los mapas alfa, las reas oscuras siempre equivalen a transparencias altas, las reas iluminadas equivalen a baja transparencia. 4: Oculta todas las reas de una textura coloreada 0,0,0 no se dibujarn en la pantalla. 8: Mipmapped versin de bajo detalle de la textura que se usar en grandes distancias. Da como resultado una apariencia borrosa. 16: Clamp u coordenada u de la textura anclada. Evita que el plegado de la textura. 32: Clamp v coordenada v de la textura anclada. Evita que el plegado de la textura. 64: mapa de reflexin esfrica mapa de ambiente, para una apariencia brillante. Una vez que se haya creado una textura, se usar SetBuffer TextureBuffer para dibujarla. Aunque, para mostrar grficos 2D en una textura, normalmente es ms rpido dibujarlos a una imagen y luego copiarlos al buffer de la textura (texturebuffer), y para mostrar grficos 3D en una textura, la nica opcin es copiar desde el backbuffer al buffer de la textura. Ver tambin: LoadTexture, LoadAnimTexture.

Ejemplo:
; CreateTexture Example ; --------------------Graphics3D 640,480 SetBuffer BackBuffer()

Ayuda Blitz Basic camera=CreateCamera() light=CreateLight() RotateEntity light,90,0,0 cube=CreateCube() PositionEntity cube,0,0,5 ; Create texture of size 256x256 tex=CreateTexture(256,256) ; Set buffer - texture buffer SetBuffer TextureBuffer(tex) ; Clear texture buffer with background white color ClsColor 255,255,255 Cls ; Draw text on texture font=LoadFont("arial",24) SetFont font Color 0,0,0 Text 0,0,"This texture" Text 0,40,"was created using" : Color 0,0,255 Text 0,80,"CreateTexture()" : Color 0,0,0 Text 0,120,"and drawn to using" : Color 0,0,255 Text 0,160,"SetBuffer TextureBuffer()" ; Texture cube with texture EntityTexture cube,tex ; Set buffer - backbuffer SetBuffer BackBuffer() While Not KeyDown( 1 ) pitch#=0 yaw#=0 roll#=0 If If If If If If KeyDown( KeyDown( KeyDown( KeyDown( KeyDown( KeyDown( 208 )=True Then pitch#=-1 200 )=True Then pitch#=1 203 )=True Then yaw#=-1 205 )=True Then yaw#=1 45 )=True Then roll#=-1 44 )=True Then roll#=1

147

TurnEntity cube,pitch#,yaw#,roll# RenderWorld Flip Wend End

LoadTexture ( archivo$[,flags] )
Parmetros:
archivo$ - nombre del archive de imagen que se usar como textura flags (opcional) flag de la textura: 1: Color 2: Alfa 4: Oculto 8: Mipmapped 16: Clamp U 32: Clamp V 64: mapa de reflexin esfrica

148

Ayuda Blitz Basic

Descripcin:
Carga una textura desde un archive de imagen y devuelve el puntero de la textura. El parmetro opcional flags permite aplicar ciertos efectos a la textura. Los flags se pueden aadir para combinar dos o ms efectos, por ejemplo 3 (1+2)= textura con color y mapas alfa. Pequea descripcin de los flags: 1: Color color del mapa, lo que ves es lo que obtienes. 2: Alfa mapa alfa. Si una imagen contiene un mapa alfa, este se usar para hacer transparentes ciertas reas de la textura. A parte de esto, el mapa de color se usar como un mapa alfa. En los mapas alfa, las reas oscuras equivalen a una alta transparencia, las reas iluminadas equivalen a una baja transparencia. 4: Oculta todas las reas de una textura coloreadas 0,0,0 no se dibujarn en la pantalla. 8: Mipmapped version de bajo detalle de la textura, se usar para distancias altas. El resultado es una apariencia suavizada y borrosa 16: Clamp u anclar textura en coordenada u. Evita el plegado de la textura. 32: Clamp v anclar textura en coordenada v. Evita el plegado de la textura. 64: mapa de reflexin esfrica mapa de ambiente, para una apariencia ms brillante Algo a tener en cuenta cuando aplicamos flags de texturas al cargar una textura es que la textura puede tener ya ciertos flags aplicados mediante el comando TextureFilter. El valor por defecto del comando TextureFilter es 9 (1+8), que es una textura coloreada y mipmapped. Esto no se puede controlar mediante el parmetro flags del comando LoadTexture si se desea eliminar los filtros ser necesario usar el comando ClearTextureFilters. Ver tambin: CreateTexture, LoadAnimTexture.

Ejemplo:
; LoadTexture Example ; ------------------Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() RotateEntity light,90,0,0 cube=CreateCube() PositionEntity cube,0,0,5 ; Load texture tex=LoadTexture("../media/b3dlogo.jpg") ; Texture cube with texture EntityTexture cube,tex While Not KeyDown( 1 ) pitch#=0 yaw#=0 roll#=0 If If If If If If KeyDown( KeyDown( KeyDown( KeyDown( KeyDown( KeyDown( 208 )=True Then pitch#=-1 200 )=True Then pitch#=1 203 )=True Then yaw#=-1 205 )=True Then yaw#=1 45 )=True Then roll#=-1 44 )=True Then roll#=1

TurnEntity cube,pitch#,yaw#,roll# RenderWorld Flip Wend End

LoadAnimTexture ( archivo$,flags,ancho_frame,alto_frame,primer_frame,contar_frame )
Parmetros:
archivo$ - nombre del archive con los frames de la animacin situados de izquierda a derecha y de arriba a abajo flags flag de la textura: 1: Color 2: Alfa 4: Oculta 8: Mipmapped

Ayuda Blitz Basic 16: Clamp U 32: Clamp V 64: Mapa de reflexin esfrica ancho_frame ancho de cada frame de animacin alto_frame alto de cada frame de animacin primer_frame el primer frame que se usar como frame de animacin. contar_frame el nmero de frames que se usar

149

Descripcin:
Carga una secuencia de frames de animacin en una textura. Ver tambin: CreateTexture, LoadTexture.

FreeTexture textura
Parmetros:
textura puntero de la textura

Descripcin:
Libera una textura. Esto permitir que la memoria que antes estaba ocupada que de libre para usarse en otros propsitos. Liberar una textura significa que no podrs volver a usarla de nuevo; aunque los entes que ya estn texturizados no perdern la textura.

Ejemplo:
; FreeTexture Example ; ------------------Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() RotateEntity light,90,0,0 cube=CreateCube() PositionEntity cube,0,0,5 ; Load texture tex=LoadTexture("../media/b3dlogo.jpg") ; Texture cube with texture EntityTexture cube,tex While Not KeyDown( 1 ) ; If spacebar pressed then free texture If KeyHit( 57 )=True Then FreeTexture tex pitch#=0 yaw#=0 roll#=0 If If If If If If KeyDown( KeyDown( KeyDown( KeyDown( KeyDown( KeyDown( 208 )=True Then pitch#=-1 200 )=True Then pitch#=1 203 )=True Then yaw#=-1 205 )=True Then yaw#=1 45 )=True Then roll#=-1 44 )=True Then roll#=1

TurnEntity cube,pitch#,yaw#,roll# RenderWorld Text 0,0,"Press spacebar to free texture" Text 0,20,"As you can see this will not effect already textured entities" Flip Wend End

150

Ayuda Blitz Basic

TextureBlend textura,mezcla
Parmetros:
textura nombre de la textura mezcla modo de mezcla de la textura 0: textura desactivada 1: alfa 2: mltiple (por defecto) 3: aadir

Descripcin:
Establece el modo de mezcla para una textura. Se usa con multitextura para controlar como la textura se combina con otras texturas.

TextureCoords textura,coordenadas
Parmetros:
textura nombre de la textura coordenadas 0: las coordenadas UV (ultravioletas) estn establecidas de primeras en los vrtices (por defecto) 1: las coordenadas UV (ultravioletas) estn establecidas de segundas en los vrtices.

Descripcin:
Establece el modo de coordinar las texturas para una textura. Esto determina donde se usan los valores UV para buscar la procedencia de una textura.

ScaleTexture textura,u_escala#,v_escala#
Parmetros:
textura nombre de la textura u_escala# - escala u v_escala# - escala v

Descripcin:
Escala una textura por un nmero absoluto. Tendr efecto inmediato sobre todos los objetos que estn usando la textura.

Ejemplo:
; ScaleTexture Example ; -------------------Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() RotateEntity light,90,0,0 cube=CreateCube() PositionEntity cube,0,0,5 ; Load texture tex=LoadTexture( "media/b3dlogo.jpg" ) ; Texture cube EntityTexture cube,tex ; Set initial uv scale values u_scale#=1 v_scale#=1 While Not KeyDown( 1 ) ; Change uv If KeyDown( If KeyDown( If KeyDown( scale values depending on key pressed 208 )=True Then u_scale#=u_scale#-0.01 200 )=True Then u_scale#=u_scale#+0.01 203 )=True Then v_scale#=v_scale#-0.01

Ayuda Blitz Basic If KeyDown( 205 )=True Then v_scale#=v_scale#+0.01 ; Scale texture ScaleTexture tex,u_scale#,v_scale# TurnEntity cube,0.1,0.1,0.1 RenderWorld Text 0,0,"Use cursor keys to change uv scale values" Text 0,20,"u_scale#="+u_scale# Text 0,40,"v_scale#="+v_scale# Flip Wend End

151

PositionTexture textura,posicin_u#,posicin_v#
Parmetros:
textura puntero de la textura posicin_u# - posicin u de la textura posicin_v# - posicin v de la textura

Descripcin:
Posiciona una textura en una posicin absoluta. Tendr un efecto inmediato en todos los objetos que usen la textura. Posicionar una textura se usa para realizar un scroll de textura, como por ejemplo agua, etc.

Ejemplo:
; PositionTexture Example ; ----------------------Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() RotateEntity light,90,0,0 cube=CreateCube() PositionEntity cube,0,0,5 ; Load texture tex=LoadTexture( "media/b3dlogo.jpg" ) ; Texture cube EntityTexture cube,tex ; Set initial uv position values u_position#=1 v_position#=1 While Not KeyDown( 1 ) ; Change uv If KeyDown( If KeyDown( If KeyDown( If KeyDown( position values 208 )=True Then 200 )=True Then 203 )=True Then 205 )=True Then depending on key pressed u_position#=u_position#-0.01 u_position#=u_position#+0.01 v_position#=v_position#-0.01 v_position#=v_position#+0.01

; Position texture PositionTexture tex,u_position#,v_position#

152 TurnEntity cube,0.1,0.1,0.1 RenderWorld Text 0,0,"Use cursor keys to change uv position values" Text 0,20,"u_position#="+u_position# Text 0,40,"v_position#="+v_position# Flip Wend End

Ayuda Blitz Basic

RotateTexture textura,ngulo#
Parmetros:
textura puntero de la textura ngulo# - ngulo absoluto de rotacin de la textura

Descripcin:
Rota una textura. Tendr efecto inmediato sobre todos los objetos en los que se usa la textura. Rotar una textura se usa mayormente para realizar el efecto remolino en texturas, como el humo, etc.

Ejemplo:
; RotateTexture Example Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() RotateEntity light,90,0,0 cube=CreateCube() PositionEntity cube,0,0,5 ; Load texture tex=LoadTexture( "media/b3dlogo.jpg" ) ; Texture cube EntityTexture cube,tex ; Set initial texture angle value angle#=1 While Not KeyDown( 1 ) ; Change texture angle value depending on key pressed If KeyDown( 205 )=True Then angle#=angle#-1 If KeyDown( 203 )=True Then angle#=angle#+1 ; Rotate texture RotateTexture tex,angle# TurnEntity cube,0.1,0.1,0.1 RenderWorld Text 0,0,"Use left and right cursor keys to change texture angle value" Text 0,20,"angle#="+angle# Flip Wend End

Ayuda Blitz Basic

153

TextureWidth (textura )
Parmetros:
textura puntero de la textura

Descripcin:
Devuelve el ancho de una textura.

TextureHeight ( textura )
Parmetros:
textura puntero de la textura

Descripcin:
Devuelve el alto de una textura.

TextureBuffer ( textura[,frame] )
Parmetros:
textura puntero de la textura frame (opcional) frame (escena) de la textura

Descripcin: Devuelve el puntero del buffer dibujado de una textura. Se puede usar con SetBuffer para realizar operaciones de dibujo 2D a la textura, aunque normalmente es ms rpido dibujar una imagen, y copiar el buffer de la imagen a travs del buffer de la textura usando CopyRect. No se puede renderizar 3D a un buffer de una textura, el 3D solo se puede renderizar al Back Buffer. Para mostrar grficos 3D en una textura, usa CopyRect para copiar el contenido del back buffer a un buffer de una textura. Ejemplo:
; TextureBuffer Example ; --------------------Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() RotateEntity light,90,0,0 cube=CreateCube() PositionEntity cube,0,0,5 ; Create texture of size 256x256 tex=CreateTexture(256,256) ; Set buffer - texture buffer SetBuffer TextureBuffer(tex) ; Clear texture buffer with background white color ClsColor 255,255,255 Cls ; Draw text on texture font=LoadFont("arial",24) SetFont font Color 0,0,0 Text 0,0,"This texture" Text 0,40,"was created using" : Color 0,0,255 Text 0,80,"CreateTexture()" : Color 0,0,0 Text 0,120,"and drawn to using" : Color 0,0,255 Text 0,160,"SetBuffer TextureBuffer()" ; Texture cube with texture EntityTexture cube,tex

154 ; Set buffer - backbuffer SetBuffer BackBuffer() While Not KeyDown( 1 ) pitch#=0 yaw#=0 roll#=0 If If If If If If KeyDown( KeyDown( KeyDown( KeyDown( KeyDown( KeyDown( 208 )=True Then pitch#=-1 200 )=True Then pitch#=1 203 )=True Then yaw#=-1 205 )=True Then yaw#=1 45 )=True Then roll#=-1 44 )=True Then roll#=1

Ayuda Blitz Basic

TurnEntity cube,pitch#,yaw#,roll# RenderWorld Flip Wend End

ClearTextureFilters
Parmetros:
Ninguno.

Descripcin:
Borra la lista actual de filtros de textura.

TextureFilter match_text$,flags
Parmetros:
match_text$ - texto que, si se encuentra en el nombre del fichero de la textura, activar ciertos filtros. flags filtro del flags

Descripcin:
Aade un filtro de textura. A cualquier textura cargada que contenga el texto especificado en match_text$ se le aadir el flags suministrado. Esto se utiliza mayormente cuando se carga una malla. Por defecto se usa el siguiente filtro de la textura: TextureFilter "",1+8. Esto significa que todas las texturas cargadas tendrn el color y el mapeado por defecto.

PINCEL CreateBrush ( [rojo#][,verde#][,azul#] )

Parmetros:
rojo# (opcional) valor rojo del pincel verde# (opcional) valor verde del pincel azul# (opcional) valor azul del pincel

Descripcin:
Crea un pincel y devuelve el puntero de un pincel. Los valores verde, rojo y azul permiten establecer el color del pincel. Los valores deberan estar en el rango 0-255. Si se omiten los valores, por defecto son 255. Un pincel es una coleccin de propiedades como Color, Alfa, Brillo, Textura, etc que se almacenan como parte de un pincel. Entonces todas estas propiedades pueden aplicarse a un ente, malla o superficie a la vez utilizando PaintEntity, PaintMesho PaintSurface. Cuando creamos nuestra propia malla, si lo deseamos podemos hacer que una determinada superficie parezca diferente a otra, es entonces cuando necesitaremos usar los pinceles para pintar superficies individuales. Usando comandos como EntityColor, EntityAlpha aplicaremos el efecto a todas las superficies a la vez, algo que tal vez no deseemos hacer. Ver tambin: LoadBrush.

Ayuda Blitz Basic

155

Ejemplo:
; CreateBrush Example ; ------------------Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() RotateEntity light,90,0,0 cube=CreateCube() PositionEntity cube,0,0,5 ; Load texture tex=LoadTexture("../media/b3dlogo.jpg") ; Create brush brush=CreateBrush() ; Apply texture to brush BrushTexture brush,tex ; And some shininess BrushShininess brush,1 ; Paint mesh with brush PaintMesh cube,brush While Not KeyDown( 1 ) pitch#=0 yaw#=0 roll#=0 If If If If If If KeyDown( KeyDown( KeyDown( KeyDown( KeyDown( KeyDown( 208 )=True Then pitch#=-1 200 )=True Then pitch#=1 203 )=True Then yaw#=-1 205 )=True Then yaw#=1 45 )=True Then roll#=-1 44 )=True Then roll#=1

TurnEntity cube,pitch#,yaw#,roll# RenderWorld Flip Wend End

LoadBrush ( archivo$[,flags][,escala_u][,escala_v]
Parmetros:
archivo$ - nombre del archive flags flags del pincel flags (opcional) se pueden aadir flags para combinar efectos: 1: Color 2: Alfa 4: Oculto 8: Mipmapped 16: Clamp U 32: Clamp V 64: mapa de reflexin esfrica escala_u escala u del pincel escala_v escala v del pincel

156

Ayuda Blitz Basic

Descripcin:
Crea un pincel, le asigna una textura y devuelve el puntero del pincel.

FreeBrush pincel
Parmetros:
pincel puntero del pincel

Descripcin:
Libera un pincel.

BrushColor brush,rojo#,verde#,azul#
Parmetros:
brush puntero del pincel rojo# - valor rojo del pincel verde# - valor verde del pincel azul# - valor azul del pincel

Descripcin:
Establece el color de un pincel. Los valores verde, rojo y azul deberan estar en el rango 0-255. El color por defecto del pincel es 255,255,255. Por favor, nota que si se est usando EntityFX o BrushFX flag 2 el color del pincel no tendr efecto y se usarn en su lugar los colores de los vrtices.

Ejemplo:
; BrushColor Example Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() RotateEntity light,90,0,0 cube=CreateCube() PositionEntity cube,0,0,5 ; Create brush brush=CreateBrush() ; Set brush color BrushColor brush,0,0,255 ; Paint mesh with brush PaintMesh cube,brush While Not KeyDown( 1 ) pitch#=0 yaw#=0 roll#=0 If If If If If If KeyDown( KeyDown( KeyDown( KeyDown( KeyDown( KeyDown( 208 )=True Then pitch#=-1 200 )=True Then pitch#=1 203 )=True Then yaw#=-1 205 )=True Then yaw#=1 45 )=True Then roll#=-1 44 )=True Then roll#=1

TurnEntity cube,pitch#,yaw#,roll# RenderWorld Flip Wend End

Ayuda Blitz Basic

157

BrushAlpha brush,alpha#
Parmetros:
brush puntero del pincel alpha# - nivel de alfa para el pincel

Descripcin:
Establece el nivel de alfa para el pincel. El valor de alpha# debera estar en el rango 0-1. El valor por defecto del alfa del pincel es 1. El nivel de alfa es como es de transparente un ente. Un valor de 1 significar que el ente no es transparente, es decir, opaco. Un valor de 0 significar que el ente es completamente transparente, es decir, invisible. Los valores entre 0 y 1 causarn variaciones en la transparencia segn el nmero, se usa para imitar la apariencia de algunos objetos como el cristal y el hielo. Un valor del alfa del pincel de 0 es especialmente prctico, porque Blitz3D no renderizar entes con dicho valor, pero los incluir en las colisiones de los entes. Es diferente a HideEntity, que no incluye los entes en las colisiones.

BrushShininess brush,brillo#
Parmetros:
brush puntero del pincel brillo# - brillo del pincel

Descripcin:
Establece el reflejo del brillo de un pincel. El valor brillo# debera estar en el rango 0-1. El valor por defecto del brillo es 0. El brillo es como brillan ciertas reas de un objeto cuando la luz les ilumina directamente. Establecer el valor del brillo en 1 para la mitad superior de una esfera, combinado con la creacin de una luz iluminando en su direccin, dar la apariencia de una bola de billar brillante.

BrushTexture brush,textura[,frame][,ndice]
Parmetros:
brush puntero del pincel textura textura a tratar frame (opcional) frame de la textura. Por defecto es 0. ndice (opcional) ndice de la textura. Por defecto es 0.

Descripcin:
Asigna una textura a un pincel. El parmetro opcional frame especifica que frame de la animacin, si existe alguno, debera asignarse al pincel. El parmetro opcional ndice especifica la capa de la textura a la que debera asignarse la textura. Los pinceles tienen cuatro capas de textura, 0-3 inclusives.

Ejemplo:
Ver Ejemplo CreateBrush

BrushBlend brush,blend
Parmetros:
brush puntero del pincel blend mezcla: 1: alfa 2: multiplicar (por defecto) 3: aadir

Descripcin:
Establece el modo de mezcla de un pincel.

BrushFX brush,fx
Parmetros:
brush puntero del pincel fx 1: brillo completo 2: usa los colores de los vrtices en lugar del color del pincel 4: flatshaded 8: desactivar niebla

158

Ayuda Blitz Basic

Descripcin:
Establece los efectos miscelnea de un pincel. Pueden aadirse flags para combinar dos o ms efectos, especificando un flag de 3(1+2) resultar un brillo completo y un pincel con el color de los vrtices.

Ejemplo: ; BrushFX Example

; ---------------Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() cone=CreateCone() PositionEntity cone,0,0,5 While Not KeyDown( 1 ) RenderWorld Flip Wend End

MALLA CreateMesh ( [padre] )

Parmetros:
padre (opcional) ente padre de la malla

Descripcin:
Crea una malla y devuelve el puntero de la malla.

LoadMesh ( archivo$[,padre] )
Parmetros:
archivo$ - nombre del archive de la malla padre (opcional) ente padre de la malla

Descripcin:
Carga una malla desde un archivo .x o .3ds y devuelve el puntero de la malla. Cualquier informacin de la animacin y de su jerarqua que est en el archivo ser ignorada. Usa LoadAnimMesh para conservar la informacin de la animacin y de su jerarqua. El parmetro opcional padre permite especificar un ente padre para la malla, de forma que cuando se mueve el padre, la malla hija se mueve con l. Aunque esta relacin slo se da en un sentido, aplicar comandos de movimiento a un hijo no afectar al padre. Especificar un ente padre crear la malla en la posicin 0,0,0 en lugar de en la posicin del ente padre. Ver tambin: LoadAnimMesh.

Ejemplo:
; LoadMesh Example Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() RotateEntity light,90,0,0 drum=LoadMesh("media/oil-drum/oildrum.3ds") PositionEntity drum,0,0,MeshDepth(drum)*2 While Not KeyDown( 1 ) RenderWorld Flip Wend End

Ayuda Blitz Basic

159

LoadAnimMesh ( archivo$[,padre] )
Parmetros:
archivo$ - nombre del archive de la malla padre ente padre de la malla

Descripcin:
Carga una malla desde un archivo .x o .3ds y devuelve el puntero de la malla. Cualquier informacin de la animacin y su jerarqua del archivo ser retenida (si est presente en el archivo!).

CreateCube( [padre] )
Parmetros:
padre (opcional) ente padre del cubo

Descripcin:
Crea una malla/ente cubo y devuelve su puntero. Un cubo se extender de -1,-1,-1 to +1,+1,+1. El parmetro opcional padre permite especificar un ente padre para el cubo para que cuando el padre sea movido, el cubo hijo se mueva con l. Aunque esta relacin solo se da en un sentido, aplicar un comando de movimiento a un hijo no afectar al padre. Especificar un ente padre dar como resultado que el cubo se cree en la posicin 0,0,0 en lugar de en la posicin del ente padre. Ver tambin: CreateSphere, CreateCylinder, CreateCone.

Ejemplo:
; CreateCube Example ; -----------------Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() RotateEntity light,90,0,0 ; Create cube cube=CreateCube() PositionEntity cube,0,0,5 While Not KeyDown( 1 ) RenderWorld Flip Wend End

CreateSphere ( [segmentos][,padre] )
Parmetros:
segmentos (opcional) detalle de la esfera. Por defecto es 8. padre (opcional) ente padre de la esfera

Descripcin:
Crea una malla/ente esfera y devuelve su puntero. La esfera se centrar en 0,0,0 y tendr un radio de 1. El valor de los segmentos debe estar en el rango 2-100 inclusive, aunque esto slo se comprueba en el modo de depuracin. Un error muy comn es dejar el modo de depuracin apagado y especificar un parmetro padre (normalmente un nmero de ocho cifras en la direccin de la memoria) en lugar del valor de los segmentos. Como el nmero de polgonos usado para crear la esfera es exponencialmente proporcional al valor de los segmentos, esto dar como resultado que Blitz intente crear una esfera con un nmero inimaginable de polgonos! Dependiendo de lo afortunado que seas, tu computador se colgar. Ejemplo de valores de segmentos: 8: 224 polgonos nmero mnimo de polgonos para una esfera 16: 960 polgonos esfera suavizada en distancias medias-altas 32: 3968 polgonos esfera suavizada en distancias cortas El parmetro opcional padre permite especificar un ente padre para la esfera, de forma que cuando el ente padre se mueve, la esfera hija se mover con l. Aunque esta relacin slo se da en un sentido, aplicar un comando de movimiento al hijo no tendr efecto sobre el padre. Especificar un ente padre har que la esfera se cree en la posicin 0,0,0 en lugar de en la posicin de ente padre. Ver tambin: CreateCube, CreateCylinder, CreateCone.

160

Ayuda Blitz Basic

Ejemplo:
; CreateSphere Example ; -------------------Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() RotateEntity light,90,0,0 ; Create sphere sphere=CreateSphere() PositionEntity sphere,0,0,5 While Not KeyDown( 1 ) RenderWorld Flip Wend End

CreateCylinder ( [segmentos][,padre][,slido] )
Parmetros:
segmentos (opcional) detalle del cilindro. Por defecto es 8. padre (opcional) ente padre del cilindro slido (opcional) - true para un cilindro, false para un tubo. Por defecto es true.

Descripcin:
Crea una malla/ente cilindro y devuelve su puntero. El cilindro se centrar en 0,0,0 y tendr un radio de 1. El valor del segmento debe estar en el rango 3-100 inclusive, aunque esto slo se comprueba en el modo de depuracin. Un error muy comn es dejar el modo de depuracin apagado y especificar un parmetro padre (normalmente una nmero de ocho cifras en la direccin de memoria) en lugar del valor de los segmentos. Como el nmero de polgonos que se usa para crear un cilindro es exponencialmente proporcional al valor de segmentos, esto causar que el Blitz trate de crear un cilindro con un nmero inimaginable de polgonos! Dependiendo de lo afortunado que seas, tu computadora se colgar. Ejemplo de valores de segmentos (slido=true): 3: 8 polgonos un prima 8: 28 polgonos nmero mnimo de polgonos para un cilindro 16: 60 polgonos cilindro suavizado a una distancia media-alta 32: 124 polgonos cilindro suavizado a una distancia corta El parmetro opcional padre permite especificar un ente padre para el cilindro de forma que cuando el padre se mueve, el cilindro hijo se mueva con l. Aunque esto solo se da en un sentido, aplicar comandos de movimiento al hijo no afectar al padre. Especificar un ente padre har que el cilindro se cree en la posicin 0,0,0 en lugar de en la posicin del ente padre. Ver tambin: CreateCube, CreateSphere, CreateCone.

Ejemplo:
; CreateCylinder Example ; ---------------------Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() RotateEntity light,90,0,0 ; Create cylinder cylinder=CreateCylinder() PositionEntity cylinder,0,0,5 While Not KeyDown( 1 ) RenderWorld Flip Wend End

Ayuda Blitz Basic

161

CreateCone ( [segmentos][,padre][,slido] )
Parmetros:
segmentos (opcional) detalles del cono. Por defecto es 8. padre (opcional) ente padre del cono slido (opcional) true para un cono con base, false para un cono sin base. Por defecto es true.

Descripcin:
Crea una malla/ente cono y devuelve su puntero. El cono se centrar en 0,0,0 y la base del cono tendr un radio de 1. El valor segmento debe estar en el rango 3-100 inclusive, aunque esto solo se comprueba en el modo de depuracin. Un error muy comn es dejar el modo de depuracin apagado y especificar el parmetro padre (normalmente un dgito de ocho cifras en la direccin de memoria) en lugar del valor de segmentos. Como el nmero de polgonos utilizados para crear un cono es exponencialmente proporcional al valor de los segmentos, esto tendr como resultado en Blitz intentar crear un cono con un nmero inimaginable de polgonos! Dependiendo de lo afortunado que seas, tu mquina se colgar. Ejemplo de valores de segmentos (slido=true): 4: 6 polgonos - una pirmide 8: 14 polgonos el nmero mnimo de polgonos para un cono 16: 30 polgonos cono suavizado a distancias medias-altas 32: 62 polgonos cono suavizado a distancias cortas El parmetro opcional padre permite especificar el ente padre del cono de forma que cuando el padre se mueve, el cono hijo se mover con el . Aunque esta relacin slo se da en un sentido, aplicar un movimiento de comando al hijo no afectar al padre. Especificar un ente padre dar como resultado que el cono se cree en la posicin 0,0,0 en lugar de en la posicin del ente padre. Ver tambin: CreateCube, CreateSphere, CreateCylinder.

Ejemplo:
; CreateCone Example ; -----------------Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() RotateEntity light,90,0,0 ; Create cone cone=CreateCone() PositionEntity cone,0,0,5 While Not KeyDown( 1 ) RenderWorld Flip Wend End

AddMesh orig_malla,dest_mesh
Parmetros:
orig_malla puntero de la malla de origen dest_malla puntero de la malla de destino

Descripcin:
Aade la malla de origen a la malla de destino.

FlipMesh malla
Parmetros:
malla puntero de la malla

Descripcin:
Voltea todos los tringulos en una malla. Se usa por un par de razones. Primeramente, es importante entender ligeramente la teora sobre los grficos 3D. Un tringulo 3D se representa mediante tres puntos, slo cuando esos tres puntos estn configurados en el sentido de las agujas del reloj, el tringulo es visible. Por lo tanto, realmente, los tringulos slo tienen un lado. Normalmente, por ejemplo en el caso de una esfera, un modelo tiene tringulos que estn dentro del modelo, no te preocupes si no puedes verlos. Aunque, que ocurrira si quisiramos usar la

162

Ayuda Blitz Basic

esfera como un enorme cielo para el mundo, es decir, si solamente necesitsemos ver el interior? En este caso, simplemente usaramos FlipMesh. Otro uso de FlipMesh es hacer objetos de bilaterales, as podremos verlos desde dentro y desde fuera si no podemos an. En este caso, copia la malla original usando CopyEntity, especificando la malla original como padre, y voltala usando FlipMesh. Ahora tendrs dos mallas ocupando el mismo espacio- esto lo har bilateral, pero cuidado, tambin dobla el nmero de polgonos! Las tcnicas de arriba son muy valiosas cuando se ha exportado un modelo de un programa externo de modelado y parece haber perdido algunos de sus tringulos.

Ejemplo:
; FlipMesh Example ; ---------------Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() ; Create sphere sphere=CreateSphere() ; Scale sphere ScaleEntity sphere,100,100,100 ; Texture sphere with sky texture sky_tex=LoadTexture("../media/sky.bmp") EntityTexture sphere,sky_tex ; Flip mesh so we can see the inside of it FlipMesh sphere Color 0,0,0 While Not KeyDown( 1 ) RenderWorld Text 0,0,"You are viewing a flipped sphere mesh - makes a great sky!" Flip Wend End

PaintMesh malla,pincel
Parmetros:
malla puntero de la malla pincel puntero del pincel

Descripcin:
Pinta una malla con un pincel. Tiene el efecto de alterar instantneamente la apariencia visible de una malla, asumiendo que las propiedades del pincel sean distintas de las aplicadas antes a la superficie. La razn de usar PaintMesh para aplicar propiedades especficas a una malla usando un pincel en lugar de usar EntityTexture, EntityColor, EntityShininess etc, es que se puede predefinir un pincel y luego usarlo para pintar mallas una y otra vez con un solo comando en lugar de un montn de comandos por separado. Ver tambin: PaintEntity, PaintSurface.

Ejemplo:
; PaintMesh Example ; ----------------Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera() light=CreateLight() RotateEntity light,90,0,0 cube=CreateCube() PositionEntity cube,0,0,5 ; Load texture tex=LoadTexture("../media/b3dlogo.jpg")

Ayuda Blitz Basic ; Create brush brush=CreateBrush() ; Apply texture to brush BrushTexture brush,tex ; And some other effects BrushColor brush,0,0,255 BrushShininess brush,1 ; Paint mesh with brush PaintMesh cube,brush While Not KeyDown( 1 ) pitch#=0 yaw#=0 roll#=0 If If If If If If KeyDown( KeyDown( KeyDown( KeyDown( KeyDown( KeyDown( 208 )=True Then pitch#=-1 200 )=True Then pitch#=1 203 )=True Then yaw#=-1 205 )=True Then yaw#=1 45 )=True Then roll#=-1 44 )=True Then roll#=1

163

TurnEntity cube,pitch#,yaw#,roll# RenderWorld Flip Wend End

LightMesh malla,rojo#,verde#,azul#[,rango#][,luz_x#][,luz_y#][,luz_z#]
Parmetros:
malla puntero de la malla rojo# - valor rojo de la malla verde# - valor verde de la malla azul# - valor azul de la malla rango# (opcional) rango de la luz luz_x# (opcional) posicin x de la luz luz_y# (opcional) posicin y de la luz luz_z# (opcional) posicin z de la luz

Descripcin:
Realiza una falsa operacin de iluminacin sobre una malla.

FitMesh malla,x#,y#,z#,ancho#,alto#,profundidad#[,uniforme]
Parmetros:
malla puntero de la malla x# - posicin x de la malla y# - posicin y de la malla z# - posicin z de la malla ancho# - ancho de la malla alto# - alto de la malla profundidad# - profundidad de la malla uniforme (opcional) si es true, la malla se escalar con el mismo nmero en x, y y z, y no se deformar. Por defecto es false.

Descripcin:
Escala y traslada todos los vertices de una malla de forma que la malla ocupe la caja especificada.

164

Ayuda Blitz Basic

ScaleMesh malla,escala_x#,escala_y#,escala_z#
Parmetros:
malla puntero de la malla escala_x# - escala de la malla en x escala_y# - escala de la malla en y escala_z# - escala de la malla en z

Descripcin:
Escala todos los vrtices de una malla segn los factores de escala especificados.

RotateMesh malla,pitch#,yaw#,roll#
Parmetros:
malla puntero de la malla pitch# - pitch de la malla yaw# - yaw de la malla roll# - roll de la malla

Descripcin:
Rota todos los vrtices de una malla segn la rotacin especificada. Pitch es lo mismo que el ngulo x de una malla, y es equivalente a inclinar alante/atrs. Yaw es lo mismo que el ngulo y de una malla, y es equivalente a girar izquierda/derecha. Roll es lo mismo que el ngulo z de una malla, y es equivalente a inclinar izquierda/derecha.

PositionMesh malla,x#,y#,z#
Parmetros:
malla puntero de la malla x# - posicin x de la malla y# - posicin y de la malla z# - posicin z de la malla

Descripcin:
Mueve todos los vrtices de una malla.

UpdateNormals malla
Parmetros:
malla puntero de la malla

Descripcin:
Recalcula todas las normales en una malla. Esto es necesario para corregir la iluminacin si no has establecido las normales de la superficie usando los comandos 'VertexNormals'.

MeshesIntersect (malla_a,malla_b )
Parmetros:
Malla_a puntero de la malla_a malla_b puntero de la malla_b

Descripcin:
Devuelve true si las mallas especificadas se estn cruzando actualmente. Esta es una rutina bastante lenta sala con discrecin... Este comando es actualmente la nica rutina de comprobacin de colisiones polgono->polgono disponible en Blitz3D.

Ejemplo:
; MeshesIntersect Example ; ----------------------Graphics3D 640,480 SetBuffer BackBuffer() camera=CreateCamera()

Ayuda Blitz Basic light=CreateLight() RotateEntity light,90,0,0 drum=LoadMesh("media/oil-drum/oildrum.3ds") PositionEntity drum,-20,0,100 crate=LoadMesh("media/wood-crate/wcrate1.3ds") PositionEntity crate,20,0,100 While Not KeyDown( 1 ) TurnEntity drum,1,1,1 TurnEntity crate,-1,-1,-1 RenderWorld

165

; Test to see if drum and crate meshes are intersecting; if so then display message to confirm this If MeshesIntersect(drum,crate)=True Then Text 0,0,"Meshes are intersecting!" Flip Wend End

MeshWidth# (malla)
Parmetros:
malla puntero de la malla

Descripcin:
Devuelve el ancho de una malla. Ver tambin: MeshHeight, MeshDepth.

MeshHeight# (malla )
Parmetros:
malla puntero de la malla

Descripcin:
Devuelve la altura de una malla. Ver tambin: MeshWidth, MeshDepth.

MeshDepth# (malla)
Parmetros: malla puntero de la malla Descripcin:
Devuelve la profundidad de una malla. Ver tambin: MeshWidth, MeshHeight.

CountSurfaces ( malla )
Parmetros:
malla puntero de la malla

Descripcin:
Devuelve el nmero de superficies (caras) en una malla. Las superficies son secciones de una malla. Una malla puede contener una seccin o varias. Ver tambin: GetSurface.

GetSurface ( malla, ndice )

Parmetros:
malla puntero de la malla ndice ndice de la superficie

166

Ayuda Blitz Basic

Descripcin:
Devuelve el puntero de una superficie unida a la malla especificada y con el nmero de ndice especificado. El ndice debera estar en el rango 1...CountSurfaces( malla ), inclusive. Necesitars obtener una superficie, es decir, averiguar su puntero, para poder usar esa superficie en particular con otros comandos. Ver tambin: CountSurfaces.

SUPERFICIE CreateSurface ( malla[,pincel] )

Parmetros:
malla puntero de la malla pincel (opcional) puntero del pincel

Descripcin:
Crea una superficie unida a una malla y devuelve el puntero de la superficie. Las superficies son secciones de malla que se usan para unir tringulos. Debe haber al menos una superficie por malla para crear una malla visible, aunque se pueden usar tantas como se quiera. Dividir una malla en varias secciones permite afectar a esas secciones individualmente, lo que es ms til que si todas las superficies estn combinadas en una sola.

PaintSurface superficie,pincel
Parmetros:
superficie puntero de la superficie pincel puntero del pincel

Descripcin:
Pinta una superficie con un pincel. Tiene el efecto de alterar instantneamente la apariencia visible de una superficie particular, por ejemplo, una seccin de malla, suponiendo que las propiedades del pincel sean diferentes de las aplicadas antes a la superficie. Ver tambin: PaintEntity, PaintMesh.

ClearSurface superficie,[limpiar_vrtices][,limpiar_tringulos]
Parmetros:
superficie puntero de la superficie limpiar_vrtices (opcional) - true para borrar todos los vrtices de la superficie especificada, false para no hacerlo. Por defecto es true. limpiar_tringulos (opcional) - true para borrar todos los tringulos de la superficie especificada, false para no hacerlo. Por defecto es true.

Descripcin:
Borra todos los vrtices y/o tringulos de una superficie. Se usa para borrar secciones de una malla. El resultado ser visible instantneamente. Despus de borrar una superficie, puede quererse crearla de nuevo pero con una ligera diferencia en el nmero de polgonos para obtener un nivel dinmico de detalle (LOD).

FindSurface ( malla,pincel)
Parmetros:
malla puntero de la malla pincel puntero del pincel

Descripcin:
Intenta encontrar una superficie unida a la malla y creada con el pincel especificado. Devuelve el puntero de la superficie si la encuentra o 0 si no la encuentra. Ver tambin: CountSurfaces, GetSurface.

AddVertex ( superficie,x#,y#,z#[,u#][,v#][,w#] )
Parmetros:
superficie puntero de la superficie x# - coordenada x del vrtice y# - coordenada y del vrtice z# - coordenada z del vrtice u# (opcional) coordenada u de la textura del vrtice v# (opcional) coordenada v de la textura del vrtice w# (opcional) coordenada w de la textura del vrtice sin utilizar, incluida para una futura expansin

Ayuda Blitz Basic

167

Descripcin:
Aade un vrtice a una superficie especificada y devuelve el nmero de ndice del vrtice, comenzando desde 0. x,y,z son las coordenadas geomtricas del vrtice, y u,v,w son las coordenadas del mapa de la textura. Un vrtice es un punto en el espacio 3D que se usa para conectar los lmites de un tringulo. Sin vrtices, no se pueden hacer tringulos. Se necesitan tres vrtices para crear un tringulo; uno por cada esquina. Los parmetros opcionales u,v permiten especificar las coordenadas de textura de un vrtice, que determinarn como ser el mapa de la textura de tringulo creado usando estos vrtices. Funciona en base a lo siguiente: el punto izquierdo ms bajo de una imagen tiene la coordenada uv 0,0. el punto derecho ms bajo tiene las coordenadas 0,1, arriba a la izquierda 0,1 y arriba a la derecha 1,1. Ahora, dependiendo de que coordenada uv ests asignando al vrtice, representar un punto en una imagen. Por ejemplo, una coordenada 0.5, 0.5 representara el centro de la imagen. Ahora imagina que tienes un tringulo equiltero normal. Asignando al vrtice abajo a la izquierda una coordenada uv de 0,0, luego abajo a la derecha la coordenada de 1,0 y arriba al centro 0.5,1, esto texturizar el tringulo con una imagen que se ajustar a l.

AddTriangle ( superficie,v0,v1,v2 )
Parmetros:
superficie superficie a tratar v0 - nmero de ndice del primer vrtice del tringulo v1 nmero de ndice del segundo vrtice del tringulo v2 nmero de ndice del tercer vrtice del tringulo

Descripcin:
Aade un tringulo a una superficie y devuelve el nmero de ndice del tringulo, comenzando desde 0. Los parmetros v0, v1 y v2 son los nmeros de ndice de los vrtices creados usando AddVertex. Dependiendo de como estn organizados los vrtices, el tringulo ser visible solo desde cierto lado. Imaginemos que diseamos los vrtices de un tringulo punto a punto, numerados como v0, v1, v2. Si estos puntos van de v0 a v2 en el sentido de las agujas del reloj, entonces el tringulo ser visible. Si estos puntos van en sentido anti-horario, entonces el tringulo no ser visible. La razn de tener tringulos de un solo lado es que reduce el nmero de tringulos necesarios para renderizar cuando un lado est orientado hacia un lado de un objeto que no se ver (como la cara interior de una pelota de billar). Sin embargo, si quieres que un tringulo tenga dos caras, puedes crear dos tringulos usando la misma configuracin de nmeros en los vrtices de ambos pero asignndolos en orden opuesto, o puedes usar CopyEntity y FlipMesh juntos.

VertexCoords superficie,ndice,x#,y#,z#
Parmetros:
superficie puntero de la superficie ndice - ndice del vrtice x# - posicin x del vrtice y# - posicin y del vrtice z# - posicin z del vrtice

Descripcin:
Establece las coordenadas geomtricas de un vrtice existente. Este es el comando que se usa para realizar lo que comnmente se conoce como 'deformacin dinmica de malla'. Reposicionar un vrtice de modo que las aristas conectadas a este tambin se movern. Esto dar el efecto de que partes de la malla se deforman de repente.

VertexNormal superficie,ndice,nx#,ny#,nz#
Parmetros:
superficie puntero de la superficie ndice - ndice del vrtice nx# - normal x del vrtice ny# - normal y del vrtice nz# - normal z del vrtice

Descripcin:
Establece la normal de un vrtice existente.

VertexColor superficie,ndice,rojo#,verde#,azul#
Parmetros:
superficie puntero de la superficie ndice - ndice del vrtice rojo# - valor rojo del vrtice verde# - valor verde del vrtice azul# - valor azul del vrtice

168

Ayuda Blitz Basic

Descripcin:
Establece el color de un vrtice existente.

VertexTexCoords superficie,ndice,u#,v#[,w#][,coord_set]
Parmetros:
superficie puntero de la superficie ndice - ndice del vrtice u# - coordenada u# del vrtice v# - coordenada v# del vrtice w# (opcional) - coordenada w# del vrtice coord_set (opcional) coordenada establecida. Debera ser establecido a 0 o 1.

Descripcin:
Establece las coordenadas de la textura de un vrtice existente.

CountVertices ( superficie )
Parmetros:
superficie puntero de la superficie

Descripcin:
Devuelve el nmero de vrtices en una superficie.

CountTriangles ( surperficie )
Parmetros:
superficie puntero de la superficie

Descripcin:
Devuelve el nmero de tringulos en una superficie.