TerminalDelegate.html 61 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <title>TerminalDelegate Protocol Reference</title>
  5. <link rel="stylesheet" type="text/css" href="../css/jazzy.css" />
  6. <link rel="stylesheet" type="text/css" href="../css/highlight.css" />
  7. <meta charset='utf-8'>
  8. <script src="../js/jquery.min.js" defer></script>
  9. <script src="../js/jazzy.js" defer></script>
  10. <script src="../js/lunr.min.js" defer></script>
  11. <script src="../js/typeahead.jquery.js" defer></script>
  12. <script src="../js/jazzy.search.js" defer></script>
  13. </head>
  14. <body>
  15. <a name="//apple_ref/swift/Protocol/TerminalDelegate" class="dashAnchor"></a>
  16. <a title="TerminalDelegate Protocol Reference"></a>
  17. <header>
  18. <div class="content-wrapper">
  19. <p><a href="../index.html">SwiftTerm 1.0 Docs</a> (68% documented)</p>
  20. <p class="header-right"><a href="https://github.com/migueldeicaza/SwiftTerm"><img src="../img/gh.png"/>View on GitHub</a></p>
  21. <p class="header-right"><a href="dash-feed://https%3A%2F%2Fmigueldeicaza.github.io%2FSwiftTerm%2Fdocsets%2FSwiftTerm.xml"><img src="../img/dash.png"/>Install in Dash</a></p>
  22. <p class="header-right">
  23. <form role="search" action="../search.json">
  24. <input type="text" placeholder="Search documentation" data-typeahead>
  25. </form>
  26. </p>
  27. </div>
  28. </header>
  29. <div class="content-wrapper">
  30. <p id="breadcrumbs">
  31. <a href="../index.html">SwiftTerm Reference</a>
  32. <img id="carat" src="../img/carat.png" />
  33. TerminalDelegate Protocol Reference
  34. </p>
  35. </div>
  36. <div class="content-wrapper">
  37. <nav class="sidebar">
  38. <ul class="nav-groups">
  39. <li class="nav-group-name">
  40. <a href="../Classes.html">Classes</a>
  41. <ul class="nav-group-tasks">
  42. <li class="nav-group-task">
  43. <a href="../Classes/BufferLine.html">BufferLine</a>
  44. </li>
  45. <li class="nav-group-task">
  46. <a href="../Classes/Color.html">Color</a>
  47. </li>
  48. <li class="nav-group-task">
  49. <a href="../Classes/HeadlessTerminal.html">HeadlessTerminal</a>
  50. </li>
  51. <li class="nav-group-task">
  52. <a href="../Classes/ImageCell.html">ImageCell</a>
  53. </li>
  54. <li class="nav-group-task">
  55. <a href="../Classes/LocalProcess.html">LocalProcess</a>
  56. </li>
  57. <li class="nav-group-task">
  58. <a href="../Classes/LocalProcessTerminalView.html">LocalProcessTerminalView</a>
  59. </li>
  60. <li class="nav-group-task">
  61. <a href="../Classes/PseudoTerminalHelpers.html">PseudoTerminalHelpers</a>
  62. </li>
  63. <li class="nav-group-task">
  64. <a href="../Classes/Terminal.html">Terminal</a>
  65. </li>
  66. <li class="nav-group-task">
  67. <a href="../Classes/Terminal/MouseMode.html">– MouseMode</a>
  68. </li>
  69. <li class="nav-group-task">
  70. <a href="../Classes/Terminal/WindowManipulationCommand.html">– WindowManipulationCommand</a>
  71. </li>
  72. <li class="nav-group-task">
  73. <a href="../Classes/Terminal/BufferKind.html">– BufferKind</a>
  74. </li>
  75. <li class="nav-group-task">
  76. <a href="../Classes/TerminalAccessory.html">TerminalAccessory</a>
  77. </li>
  78. <li class="nav-group-task">
  79. <a href="../Classes/TerminalDebugView.html">TerminalDebugView</a>
  80. </li>
  81. <li class="nav-group-task">
  82. <a href="../Classes/TerminalView.html">TerminalView</a>
  83. </li>
  84. <li class="nav-group-task">
  85. <a href="../Classes/TerminalView.html">TerminalView</a>
  86. </li>
  87. </ul>
  88. </li>
  89. <li class="nav-group-name">
  90. <a href="../Enums.html">Enumerations</a>
  91. <ul class="nav-group-tasks">
  92. <li class="nav-group-task">
  93. <a href="../Enums/CursorStyle.html">CursorStyle</a>
  94. </li>
  95. <li class="nav-group-task">
  96. <a href="../Enums/ImageSizeRequest.html">ImageSizeRequest</a>
  97. </li>
  98. </ul>
  99. </li>
  100. <li class="nav-group-name">
  101. <a href="../Extensions.html">Extensions</a>
  102. <ul class="nav-group-tasks">
  103. <li class="nav-group-task">
  104. <a href="../Extensions/TerminalViewDelegate.html">TerminalViewDelegate</a>
  105. </li>
  106. <li class="nav-group-task">
  107. <a href="../Extensions/UIImage.html">UIImage</a>
  108. </li>
  109. </ul>
  110. </li>
  111. <li class="nav-group-name">
  112. <a href="../Protocols.html">Protocols</a>
  113. <ul class="nav-group-tasks">
  114. <li class="nav-group-task">
  115. <a href="../Protocols/LocalProcessDelegate.html">LocalProcessDelegate</a>
  116. </li>
  117. <li class="nav-group-task">
  118. <a href="../Protocols/LocalProcessTerminalViewDelegate.html">LocalProcessTerminalViewDelegate</a>
  119. </li>
  120. <li class="nav-group-task">
  121. <a href="../Protocols/TerminalDelegate.html">TerminalDelegate</a>
  122. </li>
  123. <li class="nav-group-task">
  124. <a href="../Protocols/TerminalImage.html">TerminalImage</a>
  125. </li>
  126. <li class="nav-group-task">
  127. <a href="../Protocols/TerminalViewDelegate.html">TerminalViewDelegate</a>
  128. </li>
  129. </ul>
  130. </li>
  131. <li class="nav-group-name">
  132. <a href="../Structs.html">Structures</a>
  133. <ul class="nav-group-tasks">
  134. <li class="nav-group-task">
  135. <a href="../Structs/Attribute.html">Attribute</a>
  136. </li>
  137. <li class="nav-group-task">
  138. <a href="../Structs/Attribute/Color.html">– Color</a>
  139. </li>
  140. <li class="nav-group-task">
  141. <a href="../Structs/CharData.html">CharData</a>
  142. </li>
  143. <li class="nav-group-task">
  144. <a href="../Structs/CharacterStyle.html">CharacterStyle</a>
  145. </li>
  146. <li class="nav-group-task">
  147. <a href="../Structs/TerminalOptions.html">TerminalOptions</a>
  148. </li>
  149. <li class="nav-group-task">
  150. <a href="../Structs/TinyAtom.html">TinyAtom</a>
  151. </li>
  152. </ul>
  153. </li>
  154. <li class="nav-group-name">
  155. <a href="../Typealiases.html">Type Aliases</a>
  156. <ul class="nav-group-tasks">
  157. <li class="nav-group-task">
  158. <a href="../Typealiases.html#/TTImage">TTImage</a>
  159. </li>
  160. <li class="nav-group-task">
  161. <a href="../Typealiases.html#/s:9SwiftTerm7TTImagea">TTImage</a>
  162. </li>
  163. </ul>
  164. </li>
  165. </ul>
  166. </nav>
  167. <article class="main-content">
  168. <section>
  169. <section class="section">
  170. <h1>TerminalDelegate</h1>
  171. <div class="declaration">
  172. <div class="language">
  173. <pre class="highlight swift"><code><span class="kd">public</span> <span class="kd">protocol</span> <span class="kt">TerminalDelegate</span> <span class="p">:</span> <span class="kt">AnyObject</span></code></pre>
  174. </div>
  175. </div>
  176. <p>The terminal delegate is a protocol that must be implemented by a class
  177. that would provide a user interface for the terminal, and it is used by the
  178. <code><a href="../Classes/Terminal.html">Terminal</a></code> to notify of important changes on the underlying terminal</p>
  179. </section>
  180. <section class="section task-group-section">
  181. <div class="task-group">
  182. <ul>
  183. <li class="item">
  184. <div>
  185. <code>
  186. <a name="/s:9SwiftTerm16TerminalDelegateP10showCursor6sourceyAA0C0C_tF"></a>
  187. <a name="//apple_ref/swift/Method/showCursor(source:)" class="dashAnchor"></a>
  188. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP10showCursor6sourceyAA0C0C_tF">showCursor(source:<wbr>)</a>
  189. </code>
  190. <span class="declaration-note">
  191. Default implementation
  192. </span>
  193. </div>
  194. <div class="height-container">
  195. <div class="pointer-container"></div>
  196. <section class="section">
  197. <div class="pointer"></div>
  198. <div class="abstract">
  199. <p>Invoked to request that the cursor be shown</p>
  200. </div>
  201. <h4>Default Implementation</h4>
  202. <div class="default_impl abstract">
  203. </div>
  204. <div class="declaration">
  205. <h4>Declaration</h4>
  206. <div class="language">
  207. <p class="aside-title">Swift</p>
  208. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">showCursor</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">)</span></code></pre>
  209. </div>
  210. </div>
  211. </section>
  212. </div>
  213. </li>
  214. <li class="item">
  215. <div>
  216. <code>
  217. <a name="/s:9SwiftTerm16TerminalDelegateP10hideCursor6sourceyAA0C0C_tF"></a>
  218. <a name="//apple_ref/swift/Method/hideCursor(source:)" class="dashAnchor"></a>
  219. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP10hideCursor6sourceyAA0C0C_tF">hideCursor(source:<wbr>)</a>
  220. </code>
  221. <span class="declaration-note">
  222. Default implementation
  223. </span>
  224. </div>
  225. <div class="height-container">
  226. <div class="pointer-container"></div>
  227. <section class="section">
  228. <div class="pointer"></div>
  229. <div class="abstract">
  230. <p>Invoked to request that the cursor be shown</p>
  231. </div>
  232. <h4>Default Implementation</h4>
  233. <div class="default_impl abstract">
  234. </div>
  235. <div class="declaration">
  236. <h4>Declaration</h4>
  237. <div class="language">
  238. <p class="aside-title">Swift</p>
  239. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">hideCursor</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">)</span></code></pre>
  240. </div>
  241. </div>
  242. </section>
  243. </div>
  244. </li>
  245. <li class="item">
  246. <div>
  247. <code>
  248. <a name="/s:9SwiftTerm16TerminalDelegateP03setC5Title6source5titleyAA0C0C_SStF"></a>
  249. <a name="//apple_ref/swift/Method/setTerminalTitle(source:title:)" class="dashAnchor"></a>
  250. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP03setC5Title6source5titleyAA0C0C_SStF">setTerminalTitle(source:<wbr>title:<wbr>)</a>
  251. </code>
  252. <span class="declaration-note">
  253. Default implementation
  254. </span>
  255. </div>
  256. <div class="height-container">
  257. <div class="pointer-container"></div>
  258. <section class="section">
  259. <div class="pointer"></div>
  260. <div class="abstract">
  261. <p>This method is invoked when the terminal needs to set the title for the window,
  262. a UI toolkit would react by setting the terminal title in the window or any other
  263. user visible element.</p>
  264. <p>The default implementation does nothing.</p>
  265. </div>
  266. <h4>Default Implementation</h4>
  267. <div class="default_impl abstract">
  268. </div>
  269. <div class="declaration">
  270. <h4>Declaration</h4>
  271. <div class="language">
  272. <p class="aside-title">Swift</p>
  273. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">setTerminalTitle</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">,</span> <span class="nv">title</span><span class="p">:</span> <span class="kt">String</span><span class="p">)</span></code></pre>
  274. </div>
  275. </div>
  276. </section>
  277. </div>
  278. </li>
  279. <li class="item">
  280. <div>
  281. <code>
  282. <a name="/s:9SwiftTerm16TerminalDelegateP03setC9IconTitle6source5titleyAA0C0C_SStF"></a>
  283. <a name="//apple_ref/swift/Method/setTerminalIconTitle(source:title:)" class="dashAnchor"></a>
  284. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP03setC9IconTitle6source5titleyAA0C0C_SStF">setTerminalIconTitle(source:<wbr>title:<wbr>)</a>
  285. </code>
  286. <span class="declaration-note">
  287. Default implementation
  288. </span>
  289. </div>
  290. <div class="height-container">
  291. <div class="pointer-container"></div>
  292. <section class="section">
  293. <div class="pointer"></div>
  294. <div class="abstract">
  295. <p>This method is invoked when the terminal needs to set the title for the minimized icon,
  296. a UI toolkit would react by setting the terminal title in the icon or any other
  297. user visible element</p>
  298. <p>The default implementation does nothing.</p>
  299. </div>
  300. <h4>Default Implementation</h4>
  301. <div class="default_impl abstract">
  302. </div>
  303. <div class="declaration">
  304. <h4>Declaration</h4>
  305. <div class="language">
  306. <p class="aside-title">Swift</p>
  307. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">setTerminalIconTitle</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">,</span> <span class="nv">title</span><span class="p">:</span> <span class="kt">String</span><span class="p">)</span></code></pre>
  308. </div>
  309. </div>
  310. </section>
  311. </div>
  312. </li>
  313. <li class="item">
  314. <div>
  315. <code>
  316. <a name="/s:9SwiftTerm16TerminalDelegateP13windowCommand6source7commandSays5UInt8VGSgAA0C0C_AL018WindowManipulationF0OtF"></a>
  317. <a name="//apple_ref/swift/Method/windowCommand(source:command:)" class="dashAnchor"></a>
  318. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP13windowCommand6source7commandSays5UInt8VGSgAA0C0C_AL018WindowManipulationF0OtF">windowCommand(source:<wbr>command:<wbr>)</a>
  319. </code>
  320. <span class="declaration-note">
  321. Default implementation
  322. </span>
  323. </div>
  324. <div class="height-container">
  325. <div class="pointer-container"></div>
  326. <section class="section">
  327. <div class="pointer"></div>
  328. <div class="abstract">
  329. <p>These are various commands that are sent by the client. They are rare,
  330. and if you do not know what to return, just return nil, the terminal
  331. will return a suitable value.</p>
  332. <p>The response string needs to be suitable for the Xterm CSI Ps ; Ps ; Ps t command
  333. see the WindowManipulationCommand enumeration for those that need to return values</p>
  334. <p>The default implementation does nothing.</p>
  335. </div>
  336. <h4>Default Implementation</h4>
  337. <div class="default_impl abstract">
  338. </div>
  339. <div class="declaration">
  340. <h4>Declaration</h4>
  341. <div class="language">
  342. <p class="aside-title">Swift</p>
  343. <pre class="highlight swift"><code><span class="kd">@discardableResult</span>
  344. <span class="kd">func</span> <span class="nf">windowCommand</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">,</span> <span class="nv">command</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="o">.</span><span class="kt">WindowManipulationCommand</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="p">[</span><span class="kt">UInt8</span><span class="p">]?</span></code></pre>
  345. </div>
  346. </div>
  347. </section>
  348. </div>
  349. </li>
  350. <li class="item">
  351. <div>
  352. <code>
  353. <a name="/s:9SwiftTerm16TerminalDelegateP11sizeChanged6sourceyAA0C0C_tF"></a>
  354. <a name="//apple_ref/swift/Method/sizeChanged(source:)" class="dashAnchor"></a>
  355. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP11sizeChanged6sourceyAA0C0C_tF">sizeChanged(source:<wbr>)</a>
  356. </code>
  357. <span class="declaration-note">
  358. Default implementation
  359. </span>
  360. </div>
  361. <div class="height-container">
  362. <div class="pointer-container"></div>
  363. <section class="section">
  364. <div class="pointer"></div>
  365. <div class="abstract">
  366. <p>This method is invoked when the terminal dimensions have changed in response
  367. to an escape sequence that triggers a terminal resize, the user interface toolkit
  368. should attempt to accomodate the new window size</p>
  369. <p>TODO: This is not wired up</p>
  370. <p>The default implementation does nothing.</p>
  371. </div>
  372. <h4>Default Implementation</h4>
  373. <div class="default_impl abstract">
  374. </div>
  375. <div class="declaration">
  376. <h4>Declaration</h4>
  377. <div class="language">
  378. <p class="aside-title">Swift</p>
  379. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">sizeChanged</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">)</span></code></pre>
  380. </div>
  381. </div>
  382. </section>
  383. </div>
  384. </li>
  385. <li class="item">
  386. <div>
  387. <code>
  388. <a name="/s:9SwiftTerm16TerminalDelegateP4send6source4datayAA0C0C_s10ArraySliceVys5UInt8VGtF"></a>
  389. <a name="//apple_ref/swift/Method/send(source:data:)" class="dashAnchor"></a>
  390. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP4send6source4datayAA0C0C_s10ArraySliceVys5UInt8VGtF">send(source:<wbr>data:<wbr>)</a>
  391. </code>
  392. </div>
  393. <div class="height-container">
  394. <div class="pointer-container"></div>
  395. <section class="section">
  396. <div class="pointer"></div>
  397. <div class="abstract">
  398. <p>Sends the byte data to the client connected to the terminal (in terminal emulation
  399. documentation, this is the &ldquo;host&rdquo;)</p>
  400. </div>
  401. <div class="declaration">
  402. <h4>Declaration</h4>
  403. <div class="language">
  404. <p class="aside-title">Swift</p>
  405. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">send</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">,</span> <span class="nv">data</span><span class="p">:</span> <span class="kt">ArraySlice</span><span class="o">&lt;</span><span class="kt">UInt8</span><span class="o">&gt;</span><span class="p">)</span></code></pre>
  406. </div>
  407. </div>
  408. </section>
  409. </div>
  410. </li>
  411. <li class="item">
  412. <div>
  413. <code>
  414. <a name="/s:9SwiftTerm16TerminalDelegateP8scrolled6source5yDispyAA0C0C_SitF"></a>
  415. <a name="//apple_ref/swift/Method/scrolled(source:yDisp:)" class="dashAnchor"></a>
  416. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP8scrolled6source5yDispyAA0C0C_SitF">scrolled(source:<wbr>yDisp:<wbr>)</a>
  417. </code>
  418. <span class="declaration-note">
  419. Default implementation
  420. </span>
  421. </div>
  422. <div class="height-container">
  423. <div class="pointer-container"></div>
  424. <section class="section">
  425. <div class="pointer"></div>
  426. <div class="abstract">
  427. <p>Callback - the window was scrolled, new yDisplay passed
  428. The default implementation does nothing.</p>
  429. </div>
  430. <h4>Default Implementation</h4>
  431. <div class="default_impl abstract">
  432. </div>
  433. <div class="declaration">
  434. <h4>Declaration</h4>
  435. <div class="language">
  436. <p class="aside-title">Swift</p>
  437. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">scrolled</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">,</span> <span class="nv">yDisp</span><span class="p">:</span> <span class="kt">Int</span><span class="p">)</span></code></pre>
  438. </div>
  439. </div>
  440. </section>
  441. </div>
  442. </li>
  443. <li class="item">
  444. <div>
  445. <code>
  446. <a name="/s:9SwiftTerm16TerminalDelegateP8linefeed6sourceyAA0C0C_tF"></a>
  447. <a name="//apple_ref/swift/Method/linefeed(source:)" class="dashAnchor"></a>
  448. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP8linefeed6sourceyAA0C0C_tF">linefeed(source:<wbr>)</a>
  449. </code>
  450. <span class="declaration-note">
  451. Default implementation
  452. </span>
  453. </div>
  454. <div class="height-container">
  455. <div class="pointer-container"></div>
  456. <section class="section">
  457. <div class="pointer"></div>
  458. <div class="abstract">
  459. <p>Callback a newline was generated
  460. The default implementation does nothing.</p>
  461. </div>
  462. <h4>Default Implementation</h4>
  463. <div class="default_impl abstract">
  464. </div>
  465. <div class="declaration">
  466. <h4>Declaration</h4>
  467. <div class="language">
  468. <p class="aside-title">Swift</p>
  469. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">linefeed</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">)</span></code></pre>
  470. </div>
  471. </div>
  472. </section>
  473. </div>
  474. </li>
  475. <li class="item">
  476. <div>
  477. <code>
  478. <a name="/s:9SwiftTerm16TerminalDelegateP15bufferActivated6sourceyAA0C0C_tF"></a>
  479. <a name="//apple_ref/swift/Method/bufferActivated(source:)" class="dashAnchor"></a>
  480. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP15bufferActivated6sourceyAA0C0C_tF">bufferActivated(source:<wbr>)</a>
  481. </code>
  482. <span class="declaration-note">
  483. Default implementation
  484. </span>
  485. </div>
  486. <div class="height-container">
  487. <div class="pointer-container"></div>
  488. <section class="section">
  489. <div class="pointer"></div>
  490. <div class="abstract">
  491. <p>This method is invoked when the buffer changes from Normal to Alternate, or Alternate to Normal
  492. The default implementation does nothing.</p>
  493. </div>
  494. <h4>Default Implementation</h4>
  495. <div class="default_impl abstract">
  496. </div>
  497. <div class="declaration">
  498. <h4>Declaration</h4>
  499. <div class="language">
  500. <p class="aside-title">Swift</p>
  501. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">bufferActivated</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">)</span></code></pre>
  502. </div>
  503. </div>
  504. </section>
  505. </div>
  506. </li>
  507. <li class="item">
  508. <div>
  509. <code>
  510. <a name="/s:9SwiftTerm16TerminalDelegateP4bell6sourceyAA0C0C_tF"></a>
  511. <a name="//apple_ref/swift/Method/bell(source:)" class="dashAnchor"></a>
  512. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP4bell6sourceyAA0C0C_tF">bell(source:<wbr>)</a>
  513. </code>
  514. <span class="declaration-note">
  515. Default implementation
  516. </span>
  517. </div>
  518. <div class="height-container">
  519. <div class="pointer-container"></div>
  520. <section class="section">
  521. <div class="pointer"></div>
  522. <div class="abstract">
  523. <p>Should raise the bell
  524. The default implementation does nothing.</p>
  525. </div>
  526. <h4>Default Implementation</h4>
  527. <div class="default_impl abstract">
  528. </div>
  529. <div class="declaration">
  530. <h4>Declaration</h4>
  531. <div class="language">
  532. <p class="aside-title">Swift</p>
  533. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">bell</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">)</span></code></pre>
  534. </div>
  535. </div>
  536. </section>
  537. </div>
  538. </li>
  539. <li class="item">
  540. <div>
  541. <code>
  542. <a name="/s:9SwiftTerm16TerminalDelegateP16selectionChanged6sourceyAA0C0C_tF"></a>
  543. <a name="//apple_ref/swift/Method/selectionChanged(source:)" class="dashAnchor"></a>
  544. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP16selectionChanged6sourceyAA0C0C_tF">selectionChanged(source:<wbr>)</a>
  545. </code>
  546. <span class="declaration-note">
  547. Default implementation
  548. </span>
  549. </div>
  550. <div class="height-container">
  551. <div class="pointer-container"></div>
  552. <section class="section">
  553. <div class="pointer"></div>
  554. <div class="abstract">
  555. <p>This is invoked when the selection has changed, or has been turned on. The status is
  556. available in <code>terminal.selection.active</code>, and the range relative to the buffer is
  557. in <code>terminal.selection.start</code> and <code>terminal.selection.end</code></p>
  558. <p>The default implementation does nothing.</p>
  559. </div>
  560. <h4>Default Implementation</h4>
  561. <div class="default_impl abstract">
  562. </div>
  563. <div class="declaration">
  564. <h4>Declaration</h4>
  565. <div class="language">
  566. <p class="aside-title">Swift</p>
  567. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">selectionChanged</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">)</span></code></pre>
  568. </div>
  569. </div>
  570. </section>
  571. </div>
  572. </li>
  573. <li class="item">
  574. <div>
  575. <code>
  576. <a name="/s:9SwiftTerm16TerminalDelegateP16isProcessTrusted6sourceSbAA0C0C_tF"></a>
  577. <a name="//apple_ref/swift/Method/isProcessTrusted(source:)" class="dashAnchor"></a>
  578. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP16isProcessTrusted6sourceSbAA0C0C_tF">isProcessTrusted(source:<wbr>)</a>
  579. </code>
  580. <span class="declaration-note">
  581. Default implementation
  582. </span>
  583. </div>
  584. <div class="height-container">
  585. <div class="pointer-container"></div>
  586. <section class="section">
  587. <div class="pointer"></div>
  588. <div class="abstract">
  589. <p>This method should return <code>true</code> if operations that can read the buffer back should be allowed,
  590. otherwise, return false. This is useful to run some applications that attempt to checksum the
  591. contents of the screen (unit tests)</p>
  592. <p>The default implementation returns <code>true</code></p>
  593. </div>
  594. <h4>Default Implementation</h4>
  595. <div class="default_impl abstract">
  596. </div>
  597. <div class="declaration">
  598. <h4>Declaration</h4>
  599. <div class="language">
  600. <p class="aside-title">Swift</p>
  601. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">isProcessTrusted</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Bool</span></code></pre>
  602. </div>
  603. </div>
  604. </section>
  605. </div>
  606. </li>
  607. <li class="item">
  608. <div>
  609. <code>
  610. <a name="/s:9SwiftTerm16TerminalDelegateP16mouseModeChanged6sourceyAA0C0C_tF"></a>
  611. <a name="//apple_ref/swift/Method/mouseModeChanged(source:)" class="dashAnchor"></a>
  612. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP16mouseModeChanged6sourceyAA0C0C_tF">mouseModeChanged(source:<wbr>)</a>
  613. </code>
  614. <span class="declaration-note">
  615. Default implementation
  616. </span>
  617. </div>
  618. <div class="height-container">
  619. <div class="pointer-container"></div>
  620. <section class="section">
  621. <div class="pointer"></div>
  622. <div class="abstract">
  623. <p>This method is invoked when the <code>mouseMode</code> property has changed, and gives the UI
  624. a chance to update any tracking capabilities that are required in the toolkit or no longer
  625. required to provide the events.</p>
  626. <p>The default implementation ignores the mouse change</p>
  627. </div>
  628. <h4>Default Implementation</h4>
  629. <div class="default_impl abstract">
  630. </div>
  631. <div class="declaration">
  632. <h4>Declaration</h4>
  633. <div class="language">
  634. <p class="aside-title">Swift</p>
  635. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">mouseModeChanged</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">)</span></code></pre>
  636. </div>
  637. </div>
  638. </section>
  639. </div>
  640. </li>
  641. <li class="item">
  642. <div>
  643. <code>
  644. <a name="/s:9SwiftTerm16TerminalDelegateP18cursorStyleChanged6source03newF0yAA0C0C_AA06CursorF0OtF"></a>
  645. <a name="//apple_ref/swift/Method/cursorStyleChanged(source:newStyle:)" class="dashAnchor"></a>
  646. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP18cursorStyleChanged6source03newF0yAA0C0C_AA06CursorF0OtF">cursorStyleChanged(source:<wbr>newStyle:<wbr>)</a>
  647. </code>
  648. <span class="declaration-note">
  649. Default implementation
  650. </span>
  651. </div>
  652. <div class="height-container">
  653. <div class="pointer-container"></div>
  654. <section class="section">
  655. <div class="pointer"></div>
  656. <div class="abstract">
  657. <p>This method is invoked when a request to change the cursor style has been issued
  658. by client application.</p>
  659. </div>
  660. <h4>Default Implementation</h4>
  661. <div class="default_impl abstract">
  662. </div>
  663. <div class="declaration">
  664. <h4>Declaration</h4>
  665. <div class="language">
  666. <p class="aside-title">Swift</p>
  667. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">cursorStyleChanged</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">,</span> <span class="nv">newStyle</span><span class="p">:</span> <span class="kt"><a href="../Enums/CursorStyle.html">CursorStyle</a></span><span class="p">)</span></code></pre>
  668. </div>
  669. </div>
  670. </section>
  671. </div>
  672. </li>
  673. <li class="item">
  674. <div>
  675. <code>
  676. <a name="/s:9SwiftTerm16TerminalDelegateP27hostCurrentDirectoryUpdated6sourceyAA0C0C_tF"></a>
  677. <a name="//apple_ref/swift/Method/hostCurrentDirectoryUpdated(source:)" class="dashAnchor"></a>
  678. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP27hostCurrentDirectoryUpdated6sourceyAA0C0C_tF">hostCurrentDirectoryUpdated(source:<wbr>)</a>
  679. </code>
  680. <span class="declaration-note">
  681. Default implementation
  682. </span>
  683. </div>
  684. <div class="height-container">
  685. <div class="pointer-container"></div>
  686. <section class="section">
  687. <div class="pointer"></div>
  688. <div class="abstract">
  689. <p>This method is invoked when the client application has issued a command to report
  690. its current working directory (this is done with the OSC 7 command). The value can be
  691. read by accessing the <code>hostCurrentDirectory</code> property.</p>
  692. <p>The default implementaiton does nothing.</p>
  693. </div>
  694. <h4>Default Implementation</h4>
  695. <div class="default_impl abstract">
  696. </div>
  697. <div class="declaration">
  698. <h4>Declaration</h4>
  699. <div class="language">
  700. <p class="aside-title">Swift</p>
  701. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">hostCurrentDirectoryUpdated</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">)</span></code></pre>
  702. </div>
  703. </div>
  704. </section>
  705. </div>
  706. </li>
  707. <li class="item">
  708. <div>
  709. <code>
  710. <a name="/s:9SwiftTerm16TerminalDelegateP26hostCurrentDocumentUpdated6sourceyAA0C0C_tF"></a>
  711. <a name="//apple_ref/swift/Method/hostCurrentDocumentUpdated(source:)" class="dashAnchor"></a>
  712. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP26hostCurrentDocumentUpdated6sourceyAA0C0C_tF">hostCurrentDocumentUpdated(source:<wbr>)</a>
  713. </code>
  714. <span class="declaration-note">
  715. Default implementation
  716. </span>
  717. </div>
  718. <div class="height-container">
  719. <div class="pointer-container"></div>
  720. <section class="section">
  721. <div class="pointer"></div>
  722. <div class="abstract">
  723. <p>This method is invoked when the client application has issued a command to report
  724. its current document (this is done with the OSC 6 command). The value can be
  725. read by accessing the <code>hostCurrentDocument</code> property.</p>
  726. <p>The default implementaiton does nothing.</p>
  727. </div>
  728. <h4>Default Implementation</h4>
  729. <div class="default_impl abstract">
  730. </div>
  731. <div class="declaration">
  732. <h4>Declaration</h4>
  733. <div class="language">
  734. <p class="aside-title">Swift</p>
  735. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">hostCurrentDocumentUpdated</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">)</span></code></pre>
  736. </div>
  737. </div>
  738. </section>
  739. </div>
  740. </li>
  741. <li class="item">
  742. <div>
  743. <code>
  744. <a name="/s:9SwiftTerm16TerminalDelegateP12colorChanged6source3idxyAA0C0C_SiSgtF"></a>
  745. <a name="//apple_ref/swift/Method/colorChanged(source:idx:)" class="dashAnchor"></a>
  746. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP12colorChanged6source3idxyAA0C0C_SiSgtF">colorChanged(source:<wbr>idx:<wbr>)</a>
  747. </code>
  748. <span class="declaration-note">
  749. Default implementation
  750. </span>
  751. </div>
  752. <div class="height-container">
  753. <div class="pointer-container"></div>
  754. <section class="section">
  755. <div class="pointer"></div>
  756. <div class="abstract">
  757. <p>This method is invoked when a color in the 0..255 palette has been redefined, if the
  758. front-end keeps a cache or uses indexed rendering, it should update the color
  759. with the new values. If the value of idx is nil, this means all the ansi colors changed</p>
  760. </div>
  761. <h4>Default Implementation</h4>
  762. <div class="default_impl abstract">
  763. </div>
  764. <div class="declaration">
  765. <h4>Declaration</h4>
  766. <div class="language">
  767. <p class="aside-title">Swift</p>
  768. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">colorChanged</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">,</span> <span class="nv">idx</span><span class="p">:</span> <span class="kt">Int</span><span class="p">?)</span></code></pre>
  769. </div>
  770. </div>
  771. </section>
  772. </div>
  773. </li>
  774. <li class="item">
  775. <div>
  776. <code>
  777. <a name="/s:9SwiftTerm16TerminalDelegateP18setForegroundColor6source5coloryAA0C0C_AA0G0CtF"></a>
  778. <a name="//apple_ref/swift/Method/setForegroundColor(source:color:)" class="dashAnchor"></a>
  779. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP18setForegroundColor6source5coloryAA0C0C_AA0G0CtF">setForegroundColor(source:<wbr>color:<wbr>)</a>
  780. </code>
  781. <span class="declaration-note">
  782. Default implementation
  783. </span>
  784. </div>
  785. <div class="height-container">
  786. <div class="pointer-container"></div>
  787. <section class="section">
  788. <div class="pointer"></div>
  789. <div class="abstract">
  790. <p>The view should try to set the foreground color to the provided color</p>
  791. </div>
  792. <h4>Default Implementation</h4>
  793. <div class="default_impl abstract">
  794. </div>
  795. <div class="declaration">
  796. <h4>Declaration</h4>
  797. <div class="language">
  798. <p class="aside-title">Swift</p>
  799. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">setForegroundColor</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">,</span> <span class="nv">color</span><span class="p">:</span> <span class="kt"><a href="../Classes/Color.html">Color</a></span><span class="p">)</span></code></pre>
  800. </div>
  801. </div>
  802. </section>
  803. </div>
  804. </li>
  805. <li class="item">
  806. <div>
  807. <code>
  808. <a name="/s:9SwiftTerm16TerminalDelegateP18setBackgroundColor6source5coloryAA0C0C_AA0G0CtF"></a>
  809. <a name="//apple_ref/swift/Method/setBackgroundColor(source:color:)" class="dashAnchor"></a>
  810. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP18setBackgroundColor6source5coloryAA0C0C_AA0G0CtF">setBackgroundColor(source:<wbr>color:<wbr>)</a>
  811. </code>
  812. <span class="declaration-note">
  813. Default implementation
  814. </span>
  815. </div>
  816. <div class="height-container">
  817. <div class="pointer-container"></div>
  818. <section class="section">
  819. <div class="pointer"></div>
  820. <div class="abstract">
  821. <p>The view should try to set the background color to the provided color</p>
  822. </div>
  823. <h4>Default Implementation</h4>
  824. <div class="default_impl abstract">
  825. </div>
  826. <div class="declaration">
  827. <h4>Declaration</h4>
  828. <div class="language">
  829. <p class="aside-title">Swift</p>
  830. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">setBackgroundColor</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">,</span> <span class="nv">color</span><span class="p">:</span> <span class="kt"><a href="../Classes/Color.html">Color</a></span><span class="p">)</span></code></pre>
  831. </div>
  832. </div>
  833. </section>
  834. </div>
  835. </li>
  836. <li class="item">
  837. <div>
  838. <code>
  839. <a name="/s:9SwiftTerm16TerminalDelegateP9getColors6sourceAA5ColorC10foreground_AG10backgroundtAA0C0C_tF"></a>
  840. <a name="//apple_ref/swift/Method/getColors(source:)" class="dashAnchor"></a>
  841. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP9getColors6sourceAA5ColorC10foreground_AG10backgroundtAA0C0C_tF">getColors(source:<wbr>)</a>
  842. </code>
  843. <span class="declaration-note">
  844. Default implementation
  845. </span>
  846. </div>
  847. <div class="height-container">
  848. <div class="pointer-container"></div>
  849. <section class="section">
  850. <div class="pointer"></div>
  851. <div class="abstract">
  852. <p>This should return the current foreground and background colors to
  853. report.</p>
  854. </div>
  855. <h4>Default Implementation</h4>
  856. <div class="default_impl abstract">
  857. </div>
  858. <div class="declaration">
  859. <h4>Declaration</h4>
  860. <div class="language">
  861. <p class="aside-title">Swift</p>
  862. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">getColors</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">)</span> <span class="o">-&gt;</span> <span class="p">(</span><span class="nv">foreground</span><span class="p">:</span> <span class="kt"><a href="../Classes/Color.html">Color</a></span><span class="p">,</span> <span class="nv">background</span><span class="p">:</span> <span class="kt"><a href="../Classes/Color.html">Color</a></span><span class="p">)</span></code></pre>
  863. </div>
  864. </div>
  865. </section>
  866. </div>
  867. </li>
  868. <li class="item">
  869. <div>
  870. <code>
  871. <a name="/s:9SwiftTerm16TerminalDelegateP01iB7Content6source7contentyAA0C0C_s10ArraySliceVys5UInt8VGtF"></a>
  872. <a name="//apple_ref/swift/Method/iTermContent(source:content:)" class="dashAnchor"></a>
  873. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP01iB7Content6source7contentyAA0C0C_s10ArraySliceVys5UInt8VGtF">iTermContent(source:<wbr>content:<wbr>)</a>
  874. </code>
  875. <span class="declaration-note">
  876. Default implementation
  877. </span>
  878. </div>
  879. <div class="height-container">
  880. <div class="pointer-container"></div>
  881. <section class="section">
  882. <div class="pointer"></div>
  883. <div class="abstract">
  884. <p>This method is invoked when the client application (iTerm2) has issued a OSC 1337 and
  885. SwiftTerm did not handle a handler for it.</p>
  886. <p>The default implementaiton does nothing.</p>
  887. </div>
  888. <h4>Default Implementation</h4>
  889. <div class="default_impl abstract">
  890. </div>
  891. <div class="declaration">
  892. <h4>Declaration</h4>
  893. <div class="language">
  894. <p class="aside-title">Swift</p>
  895. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">iTermContent</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">,</span> <span class="nv">content</span><span class="p">:</span> <span class="kt">ArraySlice</span><span class="o">&lt;</span><span class="kt">UInt8</span><span class="o">&gt;</span><span class="p">)</span></code></pre>
  896. </div>
  897. </div>
  898. </section>
  899. </div>
  900. </li>
  901. <li class="item">
  902. <div>
  903. <code>
  904. <a name="/s:9SwiftTerm16TerminalDelegateP13clipboardCopy6source7contentyAA0C0C_10Foundation4DataVtF"></a>
  905. <a name="//apple_ref/swift/Method/clipboardCopy(source:content:)" class="dashAnchor"></a>
  906. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP13clipboardCopy6source7contentyAA0C0C_10Foundation4DataVtF">clipboardCopy(source:<wbr>content:<wbr>)</a>
  907. </code>
  908. <span class="declaration-note">
  909. Default implementation
  910. </span>
  911. </div>
  912. <div class="height-container">
  913. <div class="pointer-container"></div>
  914. <section class="section">
  915. <div class="pointer"></div>
  916. <div class="abstract">
  917. <p>This method is invoked when the client application has issued a OSC 52
  918. to put data on the clipboard.</p>
  919. </div>
  920. <h4>Default Implementation</h4>
  921. <div class="default_impl abstract">
  922. </div>
  923. <div class="declaration">
  924. <h4>Declaration</h4>
  925. <div class="language">
  926. <p class="aside-title">Swift</p>
  927. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">clipboardCopy</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">,</span> <span class="nv">content</span><span class="p">:</span> <span class="kt">Data</span><span class="p">)</span></code></pre>
  928. </div>
  929. </div>
  930. </section>
  931. </div>
  932. </li>
  933. <li class="item">
  934. <div>
  935. <code>
  936. <a name="/s:9SwiftTerm16TerminalDelegateP6notify6source5title4bodyyAA0C0C_S2StF"></a>
  937. <a name="//apple_ref/swift/Method/notify(source:title:body:)" class="dashAnchor"></a>
  938. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP6notify6source5title4bodyyAA0C0C_S2StF">notify(source:<wbr>title:<wbr>body:<wbr>)</a>
  939. </code>
  940. <span class="declaration-note">
  941. Default implementation
  942. </span>
  943. </div>
  944. <div class="height-container">
  945. <div class="pointer-container"></div>
  946. <section class="section">
  947. <div class="pointer"></div>
  948. <div class="abstract">
  949. <p>Invoked when client application issues OSC 777 to show notification.</p>
  950. <p>The default implementation does nothing.</p>
  951. </div>
  952. <h4>Default Implementation</h4>
  953. <div class="default_impl abstract">
  954. </div>
  955. <div class="declaration">
  956. <h4>Declaration</h4>
  957. <div class="language">
  958. <p class="aside-title">Swift</p>
  959. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">notify</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">,</span> <span class="nv">title</span><span class="p">:</span> <span class="kt">String</span><span class="p">,</span> <span class="nv">body</span><span class="p">:</span> <span class="kt">String</span><span class="p">)</span></code></pre>
  960. </div>
  961. </div>
  962. </section>
  963. </div>
  964. </li>
  965. <li class="item">
  966. <div>
  967. <code>
  968. <a name="/s:9SwiftTerm16TerminalDelegateP21createImageFromBitmap6source5bytes5width6heightyAA0C0C_Says5UInt8VGzS2itF"></a>
  969. <a name="//apple_ref/swift/Method/createImageFromBitmap(source:bytes:width:height:)" class="dashAnchor"></a>
  970. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP21createImageFromBitmap6source5bytes5width6heightyAA0C0C_Says5UInt8VGzS2itF">createImageFromBitmap(source:<wbr>bytes:<wbr>width:<wbr>height:<wbr>)</a>
  971. </code>
  972. <span class="declaration-note">
  973. Default implementation
  974. </span>
  975. </div>
  976. <div class="height-container">
  977. <div class="pointer-container"></div>
  978. <section class="section">
  979. <div class="pointer"></div>
  980. <div class="abstract">
  981. <p>Invoked to create an image from an RGBA buffer at the current cursor position</p>
  982. <p>The default implementation does nothing.</p>
  983. </div>
  984. <h4>Default Implementation</h4>
  985. <div class="default_impl abstract">
  986. </div>
  987. <div class="declaration">
  988. <h4>Declaration</h4>
  989. <div class="language">
  990. <p class="aside-title">Swift</p>
  991. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">createImageFromBitmap</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">,</span> <span class="nv">bytes</span><span class="p">:</span> <span class="k">inout</span> <span class="p">[</span><span class="kt">UInt8</span><span class="p">],</span> <span class="nv">width</span><span class="p">:</span> <span class="kt">Int</span><span class="p">,</span> <span class="nv">height</span><span class="p">:</span> <span class="kt">Int</span><span class="p">)</span></code></pre>
  992. </div>
  993. </div>
  994. </section>
  995. </div>
  996. </li>
  997. <li class="item">
  998. <div>
  999. <code>
  1000. <a name="/s:9SwiftTerm16TerminalDelegateP11createImage6source4data5width6height19preserveAspectRatioyAA0C0C_10Foundation4DataVAA0F11SizeRequestOAPSbtF"></a>
  1001. <a name="//apple_ref/swift/Method/createImage(source:data:width:height:preserveAspectRatio:)" class="dashAnchor"></a>
  1002. <a class="token" href="#/s:9SwiftTerm16TerminalDelegateP11createImage6source4data5width6height19preserveAspectRatioyAA0C0C_10Foundation4DataVAA0F11SizeRequestOAPSbtF">createImage(source:<wbr>data:<wbr>width:<wbr>height:<wbr>preserveAspectRatio:<wbr>)</a>
  1003. </code>
  1004. <span class="declaration-note">
  1005. Default implementation
  1006. </span>
  1007. </div>
  1008. <div class="height-container">
  1009. <div class="pointer-container"></div>
  1010. <section class="section">
  1011. <div class="pointer"></div>
  1012. <div class="abstract">
  1013. <p>Invoked to create an image from a byte blob that might be encoded in one of the various
  1014. compressed file formats (unlike the other option that gets an RGBA buffer already decoded).
  1015. It also included requests for the desired dimensions.</p>
  1016. </div>
  1017. <h4>Default Implementation</h4>
  1018. <div class="default_impl abstract">
  1019. </div>
  1020. <div class="declaration">
  1021. <h4>Declaration</h4>
  1022. <div class="language">
  1023. <p class="aside-title">Swift</p>
  1024. <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">createImage</span><span class="p">(</span><span class="nv">source</span><span class="p">:</span> <span class="kt"><a href="../Classes/Terminal.html">Terminal</a></span><span class="p">,</span> <span class="nv">data</span><span class="p">:</span> <span class="kt">Data</span><span class="p">,</span> <span class="nv">width</span><span class="p">:</span> <span class="kt"><a href="../Enums/ImageSizeRequest.html">ImageSizeRequest</a></span><span class="p">,</span> <span class="nv">height</span><span class="p">:</span> <span class="kt"><a href="../Enums/ImageSizeRequest.html">ImageSizeRequest</a></span><span class="p">,</span> <span class="nv">preserveAspectRatio</span><span class="p">:</span> <span class="kt">Bool</span><span class="p">)</span></code></pre>
  1025. </div>
  1026. </div>
  1027. </section>
  1028. </div>
  1029. </li>
  1030. </ul>
  1031. </div>
  1032. </section>
  1033. </section>
  1034. <section id="footer">
  1035. <p>&copy; 2021 <a class="link" href="https://tirania.org/" target="_blank" rel="external">Miguel de Icaza</a>. All rights reserved. (Last updated: 2021-04-28)</p>
  1036. <p>Generated by <a class="link" href="https://github.com/realm/jazzy" target="_blank" rel="external">jazzy ♪♫ v0.13.6</a>, a <a class="link" href="https://realm.io" target="_blank" rel="external">Realm</a> project.</p>
  1037. </section>
  1038. </article>
  1039. </div>
  1040. </body>
  1041. </div>
  1042. </html>