hmLoadTopic({
hmKeywords:"is_AllocImageMem",
hmTitle:"is_AllocImageMem",
hmDescription:"Syntax INT is_AllocImageMem (HIDS hf, INT width, INT height, INT bitspixel, char** ppcImgMem, INT* pid) Beschreibung is_AllocImageMem() alloziert einen Bildspeicher für ein Bild",
hmPrevLink:"is_addtosequence.html",
hmNextLink:"is_boardstatus.html",
hmParentLink:"functiondescription.html",
hmBreadCrumbs:"<a href=\"driverlibrary.html\">Beschreibung der Treiberbibliothek<\/a> &gt; <a href=\"functiondescription.html\">Funktionsbeschreibungen<\/a>",
hmTitlePath:"Beschreibung der Treiberbibliothek > Funktionsbeschreibungen > is_AllocImageMem",
hmHeader:"<h1 class=\"p_Heading1\" style=\"page-break-after: avoid;\"><span class=\"f_Heading1\">is_AllocImageMem<\/span><\/h1>\n\r",
hmBody:"<p class=\"p_Paragraph_Heading\" style=\"page-break-after: avoid;\"><span class=\"f_Paragraph_Heading\">Syntax<\/span><\/p>\n\r<p class=\"p_CodeExample\"><span class=\"f_CodeExample\">INT is_AllocImageMem (HIDS hf, INT width, INT height, INT bitspixel, char** ppcImgMem, INT* pid)<\/span><\/p>\n\r<p class=\"p_Paragraph_Heading\" style=\"page-break-after: avoid;\"><span class=\"f_Paragraph_Heading\">Beschreibung<\/span><\/p>\n\r<p class=\"p_Fliesstext\"><span class=\"f_Code_InNormalText\">is_AllocImageMem()<\/span><span class=\"f_Fliesstext\"> alloziert einen Bildspeicher für ein Bild der Breite <\/span><span class=\"f_Code_InNormalText\">width,<\/span><span class=\"f_Fliesstext\"> der Höhe <\/span><span class=\"f_Code_InNormalText\">height<\/span><span class=\"f_Fliesstext\"> und der Farbtiefe <\/span><span class=\"f_Code_InNormalText\">bitspixel.<\/span><span class=\"f_Fliesstext\"> Die Speichergröße ist mindestens:<\/span><\/p>\n\r<p class=\"p_CodeExample\"><span class=\"f_CodeExample\">size = [width &nbsp;* ((bitspixel + 1) \/ 8) + adjust] * height<\/span><\/p>\n\r<p class=\"p_Fliesstext\"><span class=\"f_Code_InNormalText\">adjust<\/span><span class=\"f_Fliesstext\"> siehe unten<\/span><\/p>\n\r<p class=\"p_Fliesstext\"><span class=\"f_Fliesstext\">Der Zeileninkrement berechnet sich zu:<\/span><\/p>\n\r<p class=\"p_Fliesstext\" style=\"text-indent: 0; padding-left: 0.8125rem; margin-left: 0;\"><span class=\"f_Code_InNormalText\" style=\"font-family: Arial,\'Lucida Sans Unicode\',\'Lucida Grande\',\'Lucida Sans\';display:inline-block;width:0.8125rem;margin-left:-0.8125rem\">&#8226;<\/span><span class=\"f_Code_InNormalText\">line = width * [(bitspixel + 1) \/ 8]<\/span><\/p><p class=\"p_Fliesstext\" style=\"text-indent: 0; padding-left: 0.8125rem; margin-left: 0;\"><span class=\"f_Code_InNormalText\" style=\"font-family: Arial,\'Lucida Sans Unicode\',\'Lucida Grande\',\'Lucida Sans\';display:inline-block;width:0.8125rem;margin-left:-0.8125rem\">&#8226;<\/span><span class=\"f_Code_InNormalText\">lineinc = line + adjust<\/span><\/p><p class=\"p_Fliesstext\" style=\"text-indent: 0; padding-left: 0.8125rem; margin-left: 0;\"><span class=\"f_Code_InNormalText\" style=\"font-family: Arial,\'Lucida Sans Unicode\',\'Lucida Grande\',\'Lucida Sans\';display:inline-block;width:0.8125rem;margin-left:-0.8125rem\">&#8226;<\/span><span class=\"f_Code_InNormalText\">adjust = 0,<\/span><span class=\"f_Fliesstext\"> wenn line ohne Rest durch 4 teilbar ist<\/span><\/p><p class=\"p_Fliesstext\" style=\"text-indent: 0; padding-left: 0.8125rem; margin-left: 0;\"><span class=\"f_Code_InNormalText\" style=\"font-family: Arial,\'Lucida Sans Unicode\',\'Lucida Grande\',\'Lucida Sans\';display:inline-block;width:0.8125rem;margin-left:-0.8125rem\">&#8226;<\/span><span class=\"f_Code_InNormalText\">adjust = 4 - rest(line \/ 4),<\/span><span class=\"f_Fliesstext\"> wenn line nicht ohne Rest durch 4 teilbar ist<\/span><\/p><p class=\"p_Fliesstext\"><span class=\"f_Fliesstext\">Das Zeileninkrement kann mit der Funktion <\/span><span class=\"f_Code_InNormalText\"><a href=\"is_getimagemempitch.html\" class=\"topiclink\">is_GetImgMemPitch()<\/a><\/span><span class=\"f_Fliesstext\"> ausgelesen werden.<\/span><\/p>\n\r<p class=\"p_Fliesstext\"><span class=\"f_Fliesstext\">Die Anfangsadresse des Speicherbereichs wird in <\/span><span class=\"f_Code_InNormalText\">ppcImgMem<\/span><span class=\"f_Fliesstext\"> zurückgegeben.<\/span><\/p>\n\r<p class=\"p_Fliesstext\"><span class=\"f_Code_InNormalText\">pid<\/span><span class=\"f_Fliesstext\"> enthält eine Identifikationsnummer des allozierten Speichers. Ein neu allozierter Speicher ist nicht direkt aktiv, d.h. Bilder werden nicht direkt in diesen neuen Speicher digitalisiert. Er muss zuerst mit <\/span><span class=\"f_Code_InNormalText\"><a href=\"is_setimagemem.html\" class=\"topiclink\">is_SetImageMem()<\/a><\/span><span class=\"f_Fliesstext\"> für das Erfassen von Einzelbildern aktiv gesetzt werden. Auf <\/span><span class=\"f_Code_InNormalText\">is_SetImageMem()<\/span><span class=\"f_Fliesstext\"> muss <\/span><span class=\"f_Code_InNormalText\"><a href=\"is_setimagesize.html\" class=\"topiclink\">is_SetImageSize()<\/a><\/span><span class=\"f_Fliesstext\"> folgen, damit die Einstellungen in den neu aktivierten Speicherbereich übertragen werden.<\/span><\/p>\n\r<p class=\"p_Fliesstext\"><span class=\"f_Fliesstext\">Der zurückgegebene Zeiger muss gesichert werden und darf nicht verändert werden, da dieser für alle weiteren <\/span><span class=\"f_Code_InNormalText\">ImageMem<\/span><span class=\"f_Fliesstext\">-Funktionen benötigt wird! Die Freigabe des Speichers erfolgt mit <\/span><span class=\"f_Code_InNormalText\"><a href=\"is_freeimagemem.html\" class=\"topiclink\">is_FreeImageMem()<\/a>.<\/span><\/p>\n\r<p class=\"p_Fliesstext\"><span class=\"f_Fliesstext\">In den DirectDraw\/Direct3D Modi ist das Allozieren eines Bildspeichers nicht notwendig!<\/span><\/p>\n\r<div style=\"text-align: left; text-indent: 0; line-height: 1.44; padding: 0 0 0 0; margin: 0.4375rem 0 0.4375rem 0;\"><table style=\"width:100%; border:none; border-spacing:0; border-collapse:collapse;\">\n\r<tr>\n\r<td style=\"vertical-align:middle; width:4.5000rem; height:3.1250rem; padding:0; border:solid 0.1250rem #008a96; border-top:none; border-bottom:none; border-left:none;\"><p class=\"p_Table_Text\"><img alt=\"hint_info\" style=\"margin:0;width:4.3750rem;height:3.1250rem;border:none\" src=\".\/images\/hint_info.png\"\/><\/p>\n\r<\/td>\n\r<td style=\"vertical-align:middle; height:3.1250rem; padding:0; border:solid 0.1250rem #008a96;\"><p class=\"p_Table_Hint\"><span class=\"f_Table_Hint\">Aktuelle Betriebssysteme lagern einzelne, länger nicht benutzte Bereiche des Arbeitsspeichers auf die langsamere Festplatte aus, falls der freie physische Arbeitsspeicher knapp wird. Daher kann sich die Bildaufnahme insgesamt verlangsamen, falls mehr Bildspeicher reserviert wurde, als gleichzeitig im Arbeitsspeicher vorgehalten werden kann.<\/span><\/p>\n\r<\/td>\n\r<\/tr>\n\r<\/table>\n\r<\/div>\n\r<p class=\"p_Paragraph_Heading\" style=\"page-break-after: avoid;\"><span class=\"f_Paragraph_Heading\">Übergabeparameter<\/span><\/p>\n\r<div style=\"text-align: left; text-indent: 0; line-height: 1.44; padding: 0 0 0 0; margin: 0.2500rem 0 0.2500rem 0;\"><table class=\"Alternating\" >\n\r<tr class=\"Alternating\">\n\r<td class=\"Alternating\"><p class=\"p_Table_Text\"><span class=\"f_Code_InNormalText\">hf<\/span><\/p>\n\r<\/td>\n\r<td class=\"Alternating\"><p class=\"p_Table_Text\"><span class=\"f_Table_Text\">Handle auf Frame Grabber<\/span><\/p>\n\r<\/td>\n\r<\/tr>\n\r<tr class=\"Alternating\">\n\r<td class=\"Alternating\" style=\"background-color:#E0E0E0;\"><p class=\"p_Table_Text\"><span class=\"f_Code_InNormalText\">width<\/span><\/p>\n\r<\/td>\n\r<td class=\"Alternating\" style=\"background-color:#E0E0E0;\"><p class=\"p_Table_Text\"><span class=\"f_Table_Text\">Breite des Bildes<\/span><\/p>\n\r<\/td>\n\r<\/tr>\n\r<tr class=\"Alternating\">\n\r<td class=\"Alternating\"><p class=\"p_Table_Text\"><span class=\"f_Code_InNormalText\">height<\/span><\/p>\n\r<\/td>\n\r<td class=\"Alternating\"><p class=\"p_Table_Text\"><span class=\"f_Table_Text\">Höhe des Bildes<\/span><\/p>\n\r<\/td>\n\r<\/tr>\n\r<tr class=\"Alternating\">\n\r<td class=\"Alternating\" style=\"background-color:#E0E0E0;\"><p class=\"p_Table_Text\"><span class=\"f_Code_InNormalText\">bitspixel<\/span><\/p>\n\r<\/td>\n\r<td class=\"Alternating\" style=\"background-color:#E0E0E0;\"><p class=\"p_Table_Text\"><span class=\"f_Table_Text\">Farbtiefe des Bildes (Bits pro Pixel)<\/span><\/p>\n\r<\/td>\n\r<\/tr>\n\r<tr class=\"Alternating\">\n\r<td class=\"Alternating\"><p class=\"p_Table_Text\"><span class=\"f_Code_InNormalText\">ppcImgMem<\/span><\/p>\n\r<\/td>\n\r<td class=\"Alternating\"><p class=\"p_Table_Text\"><span class=\"f_Table_Text\">Enthält den Zeiger auf den Speicheranfang<\/span><\/p>\n\r<\/td>\n\r<\/tr>\n\r<tr class=\"Alternating\">\n\r<td class=\"Alternating\" style=\"background-color:#E0E0E0;\"><p class=\"p_Table_Text\"><span class=\"f_Code_InNormalText\">pid<\/span><\/p>\n\r<\/td>\n\r<td class=\"Alternating\" style=\"background-color:#E0E0E0;\"><p class=\"p_Table_Text\"><span class=\"f_Table_Text\">Enthält die ID des Speichers<\/span><\/p>\n\r<\/td>\n\r<\/tr>\n\r<\/table>\n\r<\/div>\n\r<p class=\"p_Paragraph_Heading\" style=\"page-break-after: avoid;\"><span class=\"f_Paragraph_Heading\">Rückgabewert<\/span><\/p>\n\r<p class=\"p_CodeExample\"><span class=\"f_CodeExample\">IS_SUCCESS, IS_NO_SUCCESS<\/span><\/p>\n\r"
})
