HotPaw Basic for iPhone/iPad/iOS

    HotPaw icon

  • HotPaw Basic in Apple's iTunes App Store
  • HotPaw Basic for iOS on the Hotpaw website

  • The built-in Help File for HotPaw Basic for iOS (version 1.7.1)

    
    HotPaw Basic is a Classic BASIC language
    interpreter.  Line numbers are required to
    enter and edit programs.  You can edit
    a numbered line by using the "edit" command.
    (Please scroll this Help text to see more.)
    Type "help website" for more complete info.
    
    Commands and Statement Keywords:
      run new  list del  save load removefile
      let  if then else endif   dim data read restore
      for to step next  while wend  goto gosub return
      ?  print  input  open close  end stop 
      def fn  mat  randomize  cls  : rem
    
    Functions:
      int() abs() sgn()  rnd()
      sqr() exp() log() log10() sin() cos() tan() atn() 
      len() val() asc() str$() chr$() hex$() mid$() 
      ucase$() lcase$() right$() left$() field$() instr()
      eval() varptr() peek()  timer() date$ time$ pi
    
    Operators:
      +  -  *  /  mod  ^
      =   <>  >  >=  <  <=   and  or  xor  not
    
    Other special functions and commands:
      edit { line_number }
      dir	    : rem directory listing of .bas files
      removefile { filename$ }
      fn emailfile(address$, subject$, filename$)
      fn web(url$)	: rem launches Safari
      fn vibrate()
      fn solve1() : rem Newton-Raphson equation solver
      sound f,d,v : rem frequency, seconds duration, volume(0..99)
      morse m$    : rem plays morse code sounds 
      	      : rem morse string{,wpm{,vol{,dot_wpm{,freq_Hz}}}}
      fn fontsize(x)	:' changes console font size
    
    Graphics:
    
      moveto x,y
      lineto x,y    :' draws a line to x,y
      fn linewidth(w)
      graphics color r,g,b
      graphics fillrect x1,y1,x2,y2
      graphics circle r  :' circle with radius r
      fn plot1()
      fn touch(0)	:' touch detect
      fn touch(1)	:' x location in graphics display
      fn touch(2)	:' y location in graphics display
      graphics cls  :' clears graphics display
      cls		:' clears both text and graphics
    
    On iOS AirPrint enabled devices, you can print by using:
      open "lpt1:" for output as #1
      close #1 : rem print starts after file close
    
    Hints, Notes and Limitations:
    
      String variable names must end with a
      $ character.
    
      Arrays must be dimensioned before use.
    
      Input is line input.  Only one variable
      is allowed per input statement.
    
      Function subroutines with return values are 
      not supported.
    
    New commands:
    
        edit .
    
        :' Allows multi-line program editing.
    
        graphics circle r
    
        :' Draws circle at previous moveto location
    
        graphics oval x1,y1,x2,y2
    
        :' Draws an oval within the bounding rectangle
        
        graphics text s$
        
        :' Draws string at previous moveto location
    
    New special functions and commands:
    
      dim a(8) :' create an array for GPS data
      fn location(1,a(0))
        :' Reads location in array a ( time, long, lat, alt, err )
        :' Returns time stamp (it's old data if unchanged)
    
      fn location(0)
        :' Stops GPS polling
    
      dim a(8) :' create an array for motion data
      fn accelerometer(1,a(0))
        :' Reads accelerometer into array a (time, x, y , z)
        :' Returns time stamp (it's old data if unchanged)
    
      fn accelerometer(0)
        :' Stops Accelerometer polling
    
      dim b%(65536) :' required recording array size
      fn recordaudio(64,b%(0))
        :' Continues filling array b% with PCM samples.
        :' Returns index of latest sample
    
      fn recordaudio(0)
        :' Stops audio recording
        
      sound -1, a%(), n, 44100
        :' plays n 16-bit PCM samples of sound from array a%
        :' Only the 44.1kHz sample rate is supported.
        
      fn say(a$)
        :' speaks the contents of a$ using voice synthesis
    
      :' Example for fetching text or HTML from a web URL
      :'   using HTTP:
      
      open "http://..." for input as #3
      fn lof(3) :' poll this function to wait for data
      rem --- when lof becomes non-zero:
      input #3, a$   :' input strings from HTTP result
      rem --- until eof(3)
    
      :’ Core Bluetooth LE/4.0 device access functions
      :'   It may be necessary to wait 1 or 2 seconds
      :'   between any 2 blte calls,
      :    or to repeat them to receive data.
      
      fn btle.init()
        :’ initializes Bluetooth LE/4.0 access
        :’ starts a BLE scan
        :’ returns 0 if the scan has started
      fn btle.list()
        :’ presents a list of discovered BLE peripherals
      fn btle.selected()
        :’ returns the UUID string for the selected device
      fn btle.info(n,1)
        :’ returns the UUID of the nth listed device
      fn btle.info(n,2)
        :’ returns the name of the nth listed device
      fn btle.rssi(n)
        :’ returns the RSSI of the nth listed device
      fn btle.connect(1,uuid$)
        :’ connects to a BLE device
      fn btle.connect(1,uuid$,service$,chctrstc$)
        :’ connects and requests a notification
      fn btle.request(1,service$,chctrstc$)
        :’ read request for a BLE characteristic
      fn btle.response$(1,a%(0))
        :’ the read data (if any yet) as a string
        :’ set to "" after the first read
      fn btle.responsedata(1,a%(0))
        :’ the byte count of the read data (if any yet)
        :' the bytes are return in integer array
        :'   with 2 bytes per array element
        :’ set to 0 after the first read
      fn btle.write(1,service$,chctrstc$,data$)
        :’ request a write to a BLE characteristic
      fn btle(9)
        :’ disconnects from BLE device
        
      :’ LightBlue Bean BTLE communication support
      :'   fn bean functions are currently incompatible
      :'   with using any fn btle functions.
      
      fn bean.init()
      fn bean.list()
      fn bean.selected()
      fn bean.info(n,1)
      fn bean.info(n,2)
      fn bean.rssi(n)
      fn bean.connect(1,uuid$)
      
      fn bean.voltage(1)
      fn bean.temp(1)
      fn bean.led(1,r,g,b) : rem sets RGB, 0-255
      fn bean.acceleration(1,0,a%(0))
      fn bean.wrsc(1,n,s$)
        :' writes string to scratch bank 1 to 5
      fn bean.rdsc$(1,n) :rem reads bank 1 to 5
      fn bean.rdsc$(1,n,16) :rem hex string returned
      
      :' wait 1 second before using the following:
      fn.bean.serialwrite(1,s$)
      fn.bean.serialread(1,0)
    
    Other special functions and commands:
    
      :' Built-in DSP functions
    
      fn fft1( 1, x(0), y(0), n )
        :' fft arrays x,y (real & imaginary vectors, length n)
        :' n must be a power of 2, array sizes must be >= n
      fn fft1(-1, x(0), y(0), n )
        :' inverse fft
    
    Hints:
    
    Use quotes around filenames with load/save.
    
    If you quit without saving a modified program,
    it's saved automatically in the file "tmp.bas". 
    You can use fn emailfile() to email programs
    and files to yourself to save them on your PC.
    
    Use 2 fingers to swipe sideways to toggle between
    full screen view and keyboard view.
    
    There are a few other, more advanced commands
    documented on the HotPaw website:
     http://www.hotpaw.com/basic/iphone 
    or type "help website" into the console.
    
    ----
    Disclaimer: These versions of HotPaw Basic are
    distributed in the hope that they might be
    useful, but WITHOUT ANY WARRANTY OF ANY KIND; 
    not even the implied warranty of MERCHANTABILITY
    or FITNESS for ANY PARTICULAR PURPOSE. 
    (There will be many bugs!)
    
    ----
    HotPaw Basic version 1.7.7 Release Notes:
    
    1.7.7   Updated for iOS 11 and the iPhone X. (b2112.1)
            Improved support for Accessibility Larger Text.
            Basic programs can now be downloaded using iTunes File Sharing,
                or via the iOS 11 Files app.
            Graphics drawing area is now limited to 80% of full screen.
            Bug fix for an occasionally missing "stop" button.
    	Bug fixes for Core Bluetooth background mode.
    1.7.5	Fix for a problem with utf8 quoted strings.
    1.7.4	Bug fixes for the iPad Pro and some of the built-in audio functions.
    1.7.2	Bug fix for printing on iOS 8. (b22605)
    	Bug fixes for new Core Bluetooth built-in functions.
    1.7.1	Added Core Bluetooth functions.
            Bug fix for running under iOS 6.
    	(b2606 x4)
    
    1.6.9   Bug fixes for the det function and graphics text command.
    1.6.8   Improvements for iPhone 6 and 6+.
            added fn touch(3) for touch time
    	- Removed Inter-App Audio synthesizer support.
    1.6.7	Bug fixes for iOS 8 and 64-bit processor (arm64) devices.
    	- Removed Audiobus support.
    1.6.6	Fixed missing numeric input issue.
    1.6.4   Edit fix, dir fix, added MIDI input support.
    1.6.3   Keyboard cursor keys fix.
    1.6.2	Updated for iOS7.
            Graphics bug fixes.
            Added a Keyboard toolbar.  
    1.6.1   Added the fn say() command to produce synthesized speech.
    	Added HTTP to file commands for accessing web site data.
    1.5.9	Enhanced support for iPhone 5 display.
    	Added Bluetooth keyboard full screen support.
    	Improved support for International/unicode strings.
    	Increased graphics window size.
    	Added half-pixel width line drawing for Retina devices.
    	Added graphics text and graphics oval commands.
    1.5.6   fixed built-in ipad fn location() documentation
    1.5.5	added functions for reading accelerometer and location
    	added a function to read mic input into an array
    	added a new edit mode
    	added the graphics circle command
    	fixed a matrix scaling bug
    1.5.3	added mat read command
    	fixed mat command matrix multiply
    	fixed a print tab() bug
    1.5.1	Universal/iPad iOS 4.x update
    Version 1.0.8(365b0i0) - original release
    
    ---
    Copyright 2008,2010,2012,2013,2014,2015 HotPaw Productions
    Portions Copyright 1994,2000 Ronald H Nicholson Jr.
    No warranty of functionality, fitness or
    usefulness for any purpose whatsoever is
    implied.
    ---
    
    	  
  • Chipmunk Basic Language Manual - Those commands, statements, functions and operators which are supported by HotPaw Basic for iOS are identical to those of Chipmunk Basic.


Chipmunk Basic


Support