{"action":"created","issue":{"url":"https://api.github.com/repos/chrsmith/bwapi/issues/120","labels_url":"https://api.github.com/repos/chrsmith/bwapi/issues/120/labels{/name}","comments_url":"https://api.github.com/repos/chrsmith/bwapi/issues/120/comments","events_url":"https://api.github.com/repos/chrsmith/bwapi/issues/120/events","html_url":"https://github.com/chrsmith/bwapi/issues/120","id":58670501,"number":120,"title":"Request for more detailed API Documentation","user":{"login":"GoogleCodeExporter","id":9614759,"avatar_url":"https://avatars.githubusercontent.com/u/9614759?v=3","gravatar_id":"","url":"https://api.github.com/users/GoogleCodeExporter","html_url":"https://github.com/GoogleCodeExporter","followers_url":"https://api.github.com/users/GoogleCodeExporter/followers","following_url":"https://api.github.com/users/GoogleCodeExporter/following{/other_user}","gists_url":"https://api.github.com/users/GoogleCodeExporter/gists{/gist_id}","starred_url":"https://api.github.com/users/GoogleCodeExporter/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/GoogleCodeExporter/subscriptions","organizations_url":"https://api.github.com/users/GoogleCodeExporter/orgs","repos_url":"https://api.github.com/users/GoogleCodeExporter/repos","events_url":"https://api.github.com/users/GoogleCodeExporter/events{/privacy}","received_events_url":"https://api.github.com/users/GoogleCodeExporter/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/chrsmith/bwapi/labels/auto-migrated","name":"auto-migrated","color":"ededed"}],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":12,"created_at":"2015-02-23T23:55:49Z","updated_at":"2015-02-23T23:55:52Z","closed_at":"2015-02-23T23:55:49Z","body":"```\nI'm considering writing micro-management AI but I can't get the data i need\nfrom the API to control unit movement properly.  I don't know if it's\ninsufficient documentation or the functions just don't exist in the ai.  I\nneed to know:\n\n* movement options - are units limited to a number of directions (4 n,s,e,w\nor 8 nw,n,ne,e,se,...) or do they move in any possible direction?\n* there are \"walk tiles\" for mobility, yet \"pixels\" for unit position, can\nunits only stop on walk tiles or can they stop at any pixel coordinate?\n* how do i get info on whether a paticualr walk tile is passable or not\n(i.e. what is the isPassable(location) function)?  and on that, how do i\ntell if its a permanent obstacle, or one done by a building or a unit?\n* how do i get the spatial size of a unit (in pixels or walk tiles)?\n* how do i get how many pixels per frame a unit moves?  there is a \"max\nspeed\" parameter, but there are no units on them, so it's effectively\nworthless.  I NEED ALL UNITS IN FRAMES AND PIXELS.\n* i need attack range in pixels\n\n================\nComment 1  by lowerlogic, Yesterday (18 hours ago)\n\nBWAPI doesn't have movement option information, but I think I can answer\nmost of your\nother questions:\n\nStatic walkability data:\nBroodwar->walkable(x,y); //x and y in walk tile coordinates\n\nThe current set of accessible units on a build tile can be obtained via:\nBroodwar->unitsOnTile(x,y); //x and y in build tile coordinates\n\nInformation on different types of units (size, speed, attack range) can be\nfound via\nthe UnitType class at http://code.google.com/p/bwapi/wiki/UnitType\n\nUnit dimensions in pixels:\nunit->getType().dimensionLeft()\nunit->getType().dimensionUp()\nunit->getType().dimensionRight()\nunit->getType().dimensionDown()\n\nUnit dimensions in build tiles\nunit->getType().tileWidth()\nunit->getType().tileHeight()\n\nUnit speed:\nunit->getType().topSpeed()\n\nAttack range in pixels:\nunit->getType().groundWeapon()->maxRange()\nunit->getType().airWeapon()->maxRange()\n=================\nComment 2  by deathkni...@aim.com, Yesterday (18 hours ago)\n\nGo play Starcraft before you write programs for it.\n=================\nComment 3  by bgweber, Today (10 hours ago)\n\nI agree with death knight on this and have closed this issue.\n\n=================\nComment 4  by happyjack27, Today (moments ago)\n\nThank you lowerlogic.  One question remains: what units is the speed in?\n\ni have played the game, thank you very much.  playing the game won't tell\nme what units the numbers are in, will it?  looks like you didn't think\nthat one through all the way.\n\nAnd this is still an open issue because THE DOCUMENTATION HAS NOT BEEN\nUPDATED.  it still doesn't say that attack range is in pixels, dimension is\nin pixels (or even wtf \"dimensionRight\" refers to), and I still don't know\nwhat units speed is in.\n\nOr I guess if you'd prefer to answer this question yourself over and over\nagain, then you could simply NOT update the documentation.\n\nAnd whoever marked this as \"Did not look at API\": it's OBVIOUS that I DID\nread the API from THE FIRST F*CKING SENTENCE I WROTE.  So please, learn to\nread.\n\nOh, and thank you again, lowerlogic.  You were the only person that was\nhelpful.\n```\n\n-----\nOriginal issue reported on code.google.com by `happyjac...@gmail.com` on 19 Nov 2009 at 4:01"},"comment":{"url":"https://api.github.com/repos/chrsmith/bwapi/issues/comments/75665471","html_url":"https://github.com/chrsmith/bwapi/issues/120#issuecomment-75665471","issue_url":"https://api.github.com/repos/chrsmith/bwapi/issues/120","id":75665471,"user":{"login":"GoogleCodeExporter","id":9614759,"avatar_url":"https://avatars.githubusercontent.com/u/9614759?v=3","gravatar_id":"","url":"https://api.github.com/users/GoogleCodeExporter","html_url":"https://github.com/GoogleCodeExporter","followers_url":"https://api.github.com/users/GoogleCodeExporter/followers","following_url":"https://api.github.com/users/GoogleCodeExporter/following{/other_user}","gists_url":"https://api.github.com/users/GoogleCodeExporter/gists{/gist_id}","starred_url":"https://api.github.com/users/GoogleCodeExporter/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/GoogleCodeExporter/subscriptions","organizations_url":"https://api.github.com/users/GoogleCodeExporter/orgs","repos_url":"https://api.github.com/users/GoogleCodeExporter/repos","events_url":"https://api.github.com/users/GoogleCodeExporter/events{/privacy}","received_events_url":"https://api.github.com/users/GoogleCodeExporter/received_events","type":"User","site_admin":false},"created_at":"2015-02-23T23:55:51Z","updated_at":"2015-02-23T23:55:51Z","body":"\n\n-----\nOriginal comment by `AHeinerm` on 20 Nov 2009 at 2:14\n* Changed state: **Fixed**"}}